@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
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-banner
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-banner>` web component is the Magma Design System surface for contextual, in-page messages - informational notices, status callouts, and alerts - pairing an optional icon, headline, body text, and inline actions inside a single themed box.
12
12
 
@@ -14,7 +14,7 @@ The `<mds-banner>` web component is the Magma Design System surface for contextu
14
14
 
15
15
  - **Variant-driven ARIA**: The announcement role is derived from `variant`, not set manually. `error` and `warning` announce assertively (`role="alert"`); `ai`, `info`, `primary`, and `success` announce politely (`role="status"`); `light` and `dark` are decorative and silent.
16
16
  - **Headline as label**: When `headline` is set it also becomes the banner's accessible label.
17
- - **Dismissal**: When `deletable` is true a close button is rendered; activating it emits `mdsBannerClose` and, if the banner sits inside an `mds-modal`, closes that modal.
17
+ - **Dismissal**: When `dismissible` is true a close button is rendered; activating it emits `mdsBannerClose` and, if the banner sits inside an `mds-modal`, closes that modal.
18
18
  - **Localized close button**: The close button title is localized (el/en/es/it) from the host language.
19
19
  - **Action slot**: The `action` region is rendered only when a direct `[slot="action"]` child is present, so banners without actions produce no empty container.
20
20
 
@@ -26,20 +26,23 @@ This component uses the shared `variant` / `tone` ladders defined in [`agents/va
26
26
 
27
27
  - **`hideCockade`** (default `false`) removes the colored decorative badge wrapping the leading `icon`; set it for a flatter icon presentation.
28
28
  - **`icon`** is a Magma icon library slug shown at the top-left, surfaced as decorative.
29
- - **`deletable`** opts the banner into being dismissible - choose it for transient or user-acknowledged messages rather than persistent context.
29
+ - **`dismissible`** shows the close button - choose it for transient or user-acknowledged messages rather than persistent context.
30
+ - **`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.
30
31
  - The **default slot** carries the body text/markup; the **`action` slot** holds inline controls, with `mds-button` the recommended element.
31
32
 
32
33
  ## Read next
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-banner--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
39
41
 
40
42
  | Prop | Attribute | Type | Default | Description |
41
43
  | --- | --- | --- | --- | --- |
42
- | `deletable` | `deletable` | `boolean \| undefined` | - | Shows the cross icon to perform cancel/delete action on element |
44
+ | `deletable` | `deletable` | `boolean \| undefined` | - | **Deprecated**: Use `dismissible`: the button dismisses the message, it deletes nothing. Goes in the next major. Shows the close button, as `dismissible` does. |
45
+ | `dismissible` | `dismissible` | `boolean \| undefined` | - | Shows a close button that dismisses the banner: activating it emits `mdsBannerClose` |
43
46
  | `headline` | `headline` | `string \| undefined` | - | The title on the top of the banner |
44
47
  | `hideCockade` | `hide-cockade` | `boolean \| undefined` | `false` | Hides the decoration around the banner icon |
45
48
  | `icon` | `icon` | `string \| undefined` | - | An icon displayed at the top left of the banner |
@@ -59,13 +59,13 @@ The `action` named slot is the correct place for inline controls. Placing button
59
59
  </mds-banner>
60
60
  ```
61
61
 
62
- #### Do Not Set `deletable="false"` to Hide the Close Button
62
+ #### Do Not Set `dismissible="false"` to Hide the Close Button
63
63
 
64
- `deletable` is a boolean prop, and a false boolean is an absent attribute ([`agents/anti-patterns.md`](../../../../agents/anti-patterns.md)). Stencil reads the string `"false"` as `false` here, so the button is hidden, but the attribute stays on the element and any `[deletable]` selector still matches it. Remove the attribute (or omit it) to hide the button.
64
+ `dismissible` is a boolean prop, and a false boolean is an absent attribute ([`agents/anti-patterns.md`](../../../../agents/anti-patterns.md)). Stencil reads the string `"false"` as `false` here, so the button is hidden, but the attribute stays on the element and any `[dismissible]` selector still matches it. Remove the attribute (or omit it) to hide the button.
65
65
 
66
66
  ```html
67
67
  <!-- INCORRECT -->
68
- <mds-banner variant="error" deletable="false">
68
+ <mds-banner variant="error" dismissible="false">
69
69
  <mds-text typography="detail">Errore permanente - non dismissibile.</mds-text>
70
70
  </mds-banner>
71
71
 
@@ -119,7 +119,7 @@ The component fires `mdsBannerClose` only when the close button is activated (bo
119
119
 
120
120
  ```html
121
121
  <!-- INCORRECT -->
122
- <mds-banner variant="info" deletable id="notice">
122
+ <mds-banner variant="info" dismissible id="notice">
123
123
  <mds-text typography="detail">Avviso temporaneo.</mds-text>
124
124
  </mds-banner>
125
125
  <script>
@@ -129,7 +129,7 @@ The component fires `mdsBannerClose` only when the close button is activated (bo
129
129
  </script>
130
130
 
131
131
  <!-- CORRECT -->
132
- <mds-banner variant="info" deletable id="notice">
132
+ <mds-banner variant="info" dismissible id="notice">
133
133
  <mds-text typography="detail">Avviso temporaneo.</mds-text>
134
134
  </mds-banner>
135
135
  <script>
@@ -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-banner/mds-banner.tsx",
@@ -30,9 +31,9 @@
30
31
  }
31
32
  ],
32
33
  "usage": {
33
- "1. Description": "The `<mds-banner>` web component is the Magma Design System surface for contextual, in-page messages - informational notices, status callouts, and alerts - pairing an optional icon, headline, body text, and inline actions inside a single themed box.\n\n#### Semantic Behavior\n\n- **Variant-driven ARIA**: The announcement role is derived from `variant`, not set manually. `error` and `warning` announce assertively (`role=\"alert\"`); `ai`, `info`, `primary`, and `success` announce politely (`role=\"status\"`); `light` and `dark` are decorative and silent.\n- **Headline as label**: When `headline` is set it also becomes the banner's accessible label.\n- **Dismissal**: When `deletable` is true a close button is rendered; activating it emits `mdsBannerClose` and, if the banner sits inside an `mds-modal`, closes that modal.\n- **Localized close button**: The close button title is localized (el/en/es/it) from the host language.\n- **Action slot**: The `action` region is rendered only when a direct `[slot=\"action\"]` child is present, so banners without actions produce no empty container.\n\n#### Properties & Visual Configurations\n\nThis component uses the shared `variant` / `tone` ladders defined in [`agents/variants.md`](../../../../agents/variants.md); pick the `variant` according to the message's semantic weight, since it also governs the ARIA behavior described above. `tone` is limited to the minimal-box set (`'weak'`, `'strong'`, `'box'`), defaulting to `'weak'`.\n\n#### Other behavioral props\n\n- **`hideCockade`** (default `false`) removes the colored decorative badge wrapping the leading `icon`; set it for a flatter icon presentation.\n- **`icon`** is a Magma icon library slug shown at the top-left, surfaced as decorative.\n- **`deletable`** opts the banner into being dismissible - choose it for transient or user-acknowledged messages rather than persistent context.\n- The **default slot** carries the body text/markup; the **`action` slot** holds inline controls, with `mds-button` the recommended element.\n",
34
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-banner>` 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#### Informational Banner\n\nThe baseline usage. Provide `variant=\"info\"` and place the body copy in the default slot. The component derives `role=\"status\"` and `aria-live=\"polite\"` automatically from the variant.\n\n```html\n<mds-banner variant=\"info\">\n <mds-text typography=\"detail\">\n Il sistema e in manutenzione programmata dalle 22:00 alle 23:00.\n </mds-text>\n</mds-banner>\n```\n\n#### Status Variants\n\nPick the variant that matches the message's semantic weight. `error` and `warning` set `role=\"alert\"` with assertive live region; the others use `role=\"status\"` with polite announcement.\n\n```html\n<!-- Esito positivo -->\n<mds-banner variant=\"success\">\n <mds-text typography=\"detail\">Dati salvati correttamente.</mds-text>\n</mds-banner>\n\n<!-- Avviso non bloccante -->\n<mds-banner variant=\"warning\">\n <mds-text typography=\"detail\">La sessione scadra tra 5 minuti.</mds-text>\n</mds-banner>\n\n<!-- Errore bloccante -->\n<mds-banner variant=\"error\">\n <mds-text typography=\"detail\">Impossibile completare l'operazione. Riprovare.</mds-text>\n</mds-banner>\n```\n\n#### Banner with Headline\n\nUse the `headline` prop to add a title above the body text. The headline is also used as the banner's accessible label (`aria-label`).\n\n```html\n<mds-banner variant=\"warning\" headline=\"Licenza in scadenza\">\n <mds-text typography=\"detail\">\n La licenza del servizio scadra tra 7 giorni. Rinnova ora per non interrompere il servizio.\n </mds-text>\n</mds-banner>\n```\n\n#### Banner with Icon\n\nSet `icon` to a Magma icon slug. The icon is decorative (`aria-hidden=\"true\"`). The colored badge wrapping the icon is shown by default; add `hide-cockade` for a flatter look.\n\n```html\n<!-- Con cockade (default) -->\n<mds-banner variant=\"info\" icon=\"mi/baseline/info\" headline=\"Aggiornamento disponibile\">\n <mds-text typography=\"detail\">E disponibile una nuova versione dell'applicazione.</mds-text>\n</mds-banner>\n\n<!-- Senza cockade -->\n<mds-banner variant=\"success\" icon=\"mi/baseline/check-circle\" hide-cockade>\n <mds-text typography=\"detail\">Operazione completata.</mds-text>\n</mds-banner>\n```\n\n#### Dismissible Banner\n\nSet `deletable` to show a close button. The button emits `mdsBannerClose` when activated. Listen for the event to remove the banner from the DOM or update application state.\n\n```html\n<mds-banner variant=\"info\" deletable id=\"promo-banner\">\n <mds-text typography=\"detail\">\n Scopri le nuove funzioni premium disponibili nel tuo piano.\n </mds-text>\n</mds-banner>\n\n<script>\n document.querySelector('#promo-banner').addEventListener('mdsBannerClose', () => {\n document.querySelector('#promo-banner').remove();\n });\n</script>\n```\n\n#### Banner with Action Buttons\n\nSlot `<mds-button>` elements with `slot=\"action\"` to add inline controls. The action region is shown only while at least one `[slot=\"action\"]` child is present, and it follows the actions added or removed after the first render. Match the button variant to the banner variant for visual consistency.\n\n```html\n<mds-banner variant=\"warning\" headline=\"Abbonamento scaduto\">\n <mds-text typography=\"detail\">\n La licenza di questo servizio e scaduta. Il servizio continua a funzionare\n ma non puoi utilizzare le funzioni premium.\n </mds-text>\n <mds-button slot=\"action\" variant=\"warning\" tone=\"outline\">Annulla</mds-button>\n <mds-button slot=\"action\" variant=\"warning\" tone=\"strong\">Rinnova abbonamento</mds-button>\n</mds-banner>\n```\n\n#### Tone for Visual Emphasis\n\n`tone` controls emphasis without changing the semantic variant. `strong` paints the status tint on the whole banner, `weak` (default) keeps a neutral raised surface and colours only the icon, and `box` adds a solid box shadow for high-contrast placements. `mds-banner` accepts only `weak`, `strong`, and `box` - not `outline` or `text`.\n\n```html\n<!-- Bassa enfasi (default) -->\n<mds-banner variant=\"error\" tone=\"weak\">\n <mds-text typography=\"detail\">Errore di validazione nei campi del modulo.</mds-text>\n</mds-banner>\n\n<!-- Alta enfasi -->\n<mds-banner variant=\"error\" tone=\"strong\">\n <mds-text typography=\"detail\">Account bloccato per attivita sospetta. Contatta il supporto.</mds-text>\n</mds-banner>\n```\n\n#### Dark and Light Decorative Variants\n\n`variant=\"dark\"` and `variant=\"light\"` are neutral, decorative banners without an ARIA live region (`role=\"presentation\"`). Use them for non-critical UI chrome - announcements or promotional content that does not require immediate attention.\n\n```html\n<mds-banner variant=\"dark\" tone=\"strong\" headline=\"Novita del mese\">\n <mds-text typography=\"detail\">\n Tre nuovi moduli sono stati aggiunti alla piattaforma.\n </mds-text>\n <mds-button slot=\"action\" variant=\"light\" tone=\"text\">Scopri</mds-button>\n</mds-banner>\n```\n\n#### AI Variant\n\nUse `variant=\"ai\"` to mark banners that present AI-generated content or AI-powered suggestions. The variant emits a polite `role=\"status\"` live announcement.\n\n```html\n<mds-banner variant=\"ai\" icon=\"mi/baseline/auto-awesome\" headline=\"Suggerimento IA\">\n <mds-text typography=\"detail\">\n L'analisi ha rilevato tre anomalie nel documento caricato.\n </mds-text>\n <mds-button slot=\"action\" variant=\"ai\" tone=\"outline\">Visualizza dettagli</mds-button>\n</mds-banner>\n```\n\n#### Dismissible Banner inside mds-modal\n\nWhen `deletable` is set and the banner lives inside an `<mds-modal>`, activating the close button emits `mdsBannerClose` and also closes the modal automatically - no extra JavaScript needed.\n\n```html\n<mds-modal opened>\n <mds-banner variant=\"warning\" deletable headline=\"Attenzione\">\n <mds-text typography=\"detail\">\n Stai per eliminare tutti i dati. L'azione non e reversibile.\n </mds-text>\n <mds-button slot=\"action\" variant=\"warning\" tone=\"outline\">Annulla</mds-button>\n <mds-button slot=\"action\" variant=\"warning\" tone=\"strong\">Elimina</mds-button>\n </mds-banner>\n</mds-modal>\n```\n\n#### CSS Custom Property Customization\n\nOverride appearance only through the public `--mds-banner-*` custom properties. Set them on the host or a parent selector; use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.featured-notice mds-banner {\n --mds-banner-background: rgb(var(--magma-accent-emphasis));\n --mds-banner-color: rgb(var(--magma-accent-on-emphasis));\n --mds-banner-radius: var(--magma-radius-sm);\n --mds-banner-shadow: 0 4px 16px rgb(var(--magma-shadow-ink) / 0.15);\n}\n```\n",
35
- "3. Antipattern": "Common incorrect uses of `<mds-banner>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use an Invalid `tone` Value\n\n`mds-banner.tone` is typed as `ToneMinimalBoxVariantType`, which allows only `weak`, `strong`, and `box`. Values like `outline` or `text` are not accepted: no tone style matches them, so the banner renders as with `strong`, not with the `weak` default.\n\n```html\n<!-- INCORRECT -->\n<mds-banner variant=\"info\" tone=\"outline\">\n <mds-text typography=\"detail\">Informazione di sistema.</mds-text>\n</mds-banner>\n\n<!-- CORRECT -->\n<mds-banner variant=\"info\" tone=\"weak\">\n <mds-text typography=\"detail\">Informazione di sistema.</mds-text>\n</mds-banner>\n```\n\n#### Do Not Override the ARIA Role Manually\n\nThe component derives `role` and `aria-live` from `variant` (`error`/`warning` assertive, others polite) and writes them on the host when it renders, overwriting a manual value. To change the announcement, change the `variant`.\n\n```html\n<!-- INCORRECT -->\n<mds-banner variant=\"info\" role=\"alert\" aria-live=\"assertive\">\n <mds-text typography=\"detail\">Aggiornamento disponibile.</mds-text>\n</mds-banner>\n\n<!-- CORRECT - let variant drive the ARIA behavior -->\n<mds-banner variant=\"info\">\n <mds-text typography=\"detail\">Aggiornamento disponibile.</mds-text>\n</mds-banner>\n```\n\n#### Do Not Slot an `mds-button` into the Default Slot to Add Actions\n\nThe `action` named slot is the correct place for inline controls. Placing buttons in the default slot renders them inside the text region, breaks layout, and loses the flex wrapping the action row provides.\n\n```html\n<!-- INCORRECT -->\n<mds-banner variant=\"warning\">\n <mds-text typography=\"detail\">La licenza sta per scadere.</mds-text>\n <mds-button variant=\"warning\">Rinnova</mds-button>\n</mds-banner>\n\n<!-- CORRECT -->\n<mds-banner variant=\"warning\">\n <mds-text typography=\"detail\">La licenza sta per scadere.</mds-text>\n <mds-button slot=\"action\" variant=\"warning\" tone=\"strong\">Rinnova</mds-button>\n</mds-banner>\n```\n\n#### Do Not Set `deletable=\"false\"` to Hide the Close Button\n\n`deletable` is a boolean prop, and a false boolean is an absent attribute ([`agents/anti-patterns.md`](../../../../agents/anti-patterns.md)). Stencil reads the string `\"false\"` as `false` here, so the button is hidden, but the attribute stays on the element and any `[deletable]` selector still matches it. Remove the attribute (or omit it) to hide the button.\n\n```html\n<!-- INCORRECT -->\n<mds-banner variant=\"error\" deletable=\"false\">\n <mds-text typography=\"detail\">Errore permanente - non dismissibile.</mds-text>\n</mds-banner>\n\n<!-- CORRECT -->\n<mds-banner variant=\"error\">\n <mds-text typography=\"detail\">Errore permanente - non dismissibile.</mds-text>\n</mds-banner>\n```\n\n#### Do Not Use `dark` or `light` for Status Messages\n\n`variant=\"dark\"` and `variant=\"light\"` produce `role=\"presentation\"` with no live region - they are silent to assistive tech. Using them for error, warning, or informational content means screen reader users never receive the announcement.\n\n```html\n<!-- INCORRECT - errore silenzioso per tecnologie assistive -->\n<mds-banner variant=\"dark\">\n <mds-text typography=\"detail\">Errore: impossibile caricare il documento.</mds-text>\n</mds-banner>\n\n<!-- CORRECT -->\n<mds-banner variant=\"error\">\n <mds-text typography=\"detail\">Errore: impossibile caricare il documento.</mds-text>\n</mds-banner>\n```\n\n#### Do Not Pierce Shadow DOM to Style Internals\n\nThe only supported customization surface is the public `--mds-banner-*` CSS custom properties plus the `::part(text)` shadow part. Targeting internal class names with `>>>` or undocumented `::part()` names couples your code to the implementation and breaks on minor releases.\n\n```css\n/* INCORRECT */\nmds-banner >>> .headline {\n font-size: 1.5rem;\n}\nmds-banner::part(content) {\n padding: 0;\n}\n\n/* CORRECT */\nmds-banner {\n --mds-banner-radius: var(--magma-radius-sm);\n}\nmds-banner::part(text) {\n line-height: 1.6;\n}\n```\n\n#### Do Not Listen to the Native `click` Event for Dismissal\n\nThe component fires `mdsBannerClose` only when the close button is activated (both pointer and keyboard). A native `click` listener on the host fires for a click anywhere in the banner, body text and action buttons included.\n\n```html\n<!-- INCORRECT -->\n<mds-banner variant=\"info\" deletable id=\"notice\">\n <mds-text typography=\"detail\">Avviso temporaneo.</mds-text>\n</mds-banner>\n<script>\n document.querySelector('#notice').addEventListener('click', () => {\n document.querySelector('#notice').remove();\n });\n</script>\n\n<!-- CORRECT -->\n<mds-banner variant=\"info\" deletable id=\"notice\">\n <mds-text typography=\"detail\">Avviso temporaneo.</mds-text>\n</mds-banner>\n<script>\n document.querySelector('#notice').addEventListener('mdsBannerClose', () => {\n document.querySelector('#notice').remove();\n });\n</script>\n```\n"
34
+ "1. Description": "The `<mds-banner>` web component is the Magma Design System surface for contextual, in-page messages - informational notices, status callouts, and alerts - pairing an optional icon, headline, body text, and inline actions inside a single themed box.\n\n#### Semantic Behavior\n\n- **Variant-driven ARIA**: The announcement role is derived from `variant`, not set manually. `error` and `warning` announce assertively (`role=\"alert\"`); `ai`, `info`, `primary`, and `success` announce politely (`role=\"status\"`); `light` and `dark` are decorative and silent.\n- **Headline as label**: When `headline` is set it also becomes the banner's accessible label.\n- **Dismissal**: When `dismissible` is true a close button is rendered; activating it emits `mdsBannerClose` and, if the banner sits inside an `mds-modal`, closes that modal.\n- **Localized close button**: The close button title is localized (el/en/es/it) from the host language.\n- **Action slot**: The `action` region is rendered only when a direct `[slot=\"action\"]` child is present, so banners without actions produce no empty container.\n\n#### Properties & Visual Configurations\n\nThis component uses the shared `variant` / `tone` ladders defined in [`agents/variants.md`](../../../../agents/variants.md); pick the `variant` according to the message's semantic weight, since it also governs the ARIA behavior described above. `tone` is limited to the minimal-box set (`'weak'`, `'strong'`, `'box'`), defaulting to `'weak'`.\n\n#### Other behavioral props\n\n- **`hideCockade`** (default `false`) removes the colored decorative badge wrapping the leading `icon`; set it for a flatter icon presentation.\n- **`icon`** is a Magma icon library slug shown at the top-left, surfaced as decorative.\n- **`dismissible`** shows the close button - choose it for transient or user-acknowledged messages rather than persistent context.\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- The **default slot** carries the body text/markup; the **`action` slot** holds inline controls, with `mds-button` the recommended element.\n",
35
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-banner>` 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#### Informational Banner\n\nThe baseline usage. Provide `variant=\"info\"` and place the body copy in the default slot. The component derives `role=\"status\"` and `aria-live=\"polite\"` automatically from the variant.\n\n```html\n<mds-banner variant=\"info\">\n <mds-text typography=\"detail\">\n Il sistema e in manutenzione programmata dalle 22:00 alle 23:00.\n </mds-text>\n</mds-banner>\n```\n\n#### Status Variants\n\nPick the variant that matches the message's semantic weight. `error` and `warning` set `role=\"alert\"` with assertive live region; the others use `role=\"status\"` with polite announcement.\n\n```html\n<!-- Esito positivo -->\n<mds-banner variant=\"success\">\n <mds-text typography=\"detail\">Dati salvati correttamente.</mds-text>\n</mds-banner>\n\n<!-- Avviso non bloccante -->\n<mds-banner variant=\"warning\">\n <mds-text typography=\"detail\">La sessione scadra tra 5 minuti.</mds-text>\n</mds-banner>\n\n<!-- Errore bloccante -->\n<mds-banner variant=\"error\">\n <mds-text typography=\"detail\">Impossibile completare l'operazione. Riprovare.</mds-text>\n</mds-banner>\n```\n\n#### Banner with Headline\n\nUse the `headline` prop to add a title above the body text. The headline is also used as the banner's accessible label (`aria-label`).\n\n```html\n<mds-banner variant=\"warning\" headline=\"Licenza in scadenza\">\n <mds-text typography=\"detail\">\n La licenza del servizio scadra tra 7 giorni. Rinnova ora per non interrompere il servizio.\n </mds-text>\n</mds-banner>\n```\n\n#### Banner with Icon\n\nSet `icon` to a Magma icon slug. The icon is decorative (`aria-hidden=\"true\"`). The colored badge wrapping the icon is shown by default; add `hide-cockade` for a flatter look.\n\n```html\n<!-- Con cockade (default) -->\n<mds-banner variant=\"info\" icon=\"mi/baseline/info\" headline=\"Aggiornamento disponibile\">\n <mds-text typography=\"detail\">E disponibile una nuova versione dell'applicazione.</mds-text>\n</mds-banner>\n\n<!-- Senza cockade -->\n<mds-banner variant=\"success\" icon=\"mi/baseline/check-circle\" hide-cockade>\n <mds-text typography=\"detail\">Operazione completata.</mds-text>\n</mds-banner>\n```\n\n#### Dismissible Banner\n\nSet `dismissible` to show a close button. The button emits `mdsBannerClose` when activated. Listen for the event to remove the banner from the DOM or update application state.\n\n```html\n<mds-banner variant=\"info\" dismissible id=\"promo-banner\">\n <mds-text typography=\"detail\">\n Scopri le nuove funzioni premium disponibili nel tuo piano.\n </mds-text>\n</mds-banner>\n\n<script>\n document.querySelector('#promo-banner').addEventListener('mdsBannerClose', () => {\n document.querySelector('#promo-banner').remove();\n });\n</script>\n```\n\n#### Banner with Action Buttons\n\nSlot `<mds-button>` elements with `slot=\"action\"` to add inline controls. The action region is shown only while at least one `[slot=\"action\"]` child is present, and it follows the actions added or removed after the first render. Match the button variant to the banner variant for visual consistency.\n\n```html\n<mds-banner variant=\"warning\" headline=\"Abbonamento scaduto\">\n <mds-text typography=\"detail\">\n La licenza di questo servizio e scaduta. Il servizio continua a funzionare\n ma non puoi utilizzare le funzioni premium.\n </mds-text>\n <mds-button slot=\"action\" variant=\"warning\" tone=\"outline\">Annulla</mds-button>\n <mds-button slot=\"action\" variant=\"warning\" tone=\"strong\">Rinnova abbonamento</mds-button>\n</mds-banner>\n```\n\n#### Tone for Visual Emphasis\n\n`tone` controls emphasis without changing the semantic variant. `strong` paints the status tint on the whole banner, `weak` (default) keeps a neutral raised surface and colours only the icon, and `box` adds a solid box shadow for high-contrast placements. `mds-banner` accepts only `weak`, `strong`, and `box` - not `outline` or `text`.\n\n```html\n<!-- Bassa enfasi (default) -->\n<mds-banner variant=\"error\" tone=\"weak\">\n <mds-text typography=\"detail\">Errore di validazione nei campi del modulo.</mds-text>\n</mds-banner>\n\n<!-- Alta enfasi -->\n<mds-banner variant=\"error\" tone=\"strong\">\n <mds-text typography=\"detail\">Account bloccato per attivita sospetta. Contatta il supporto.</mds-text>\n</mds-banner>\n```\n\n#### Dark and Light Decorative Variants\n\n`variant=\"dark\"` and `variant=\"light\"` are neutral, decorative banners without an ARIA live region (`role=\"presentation\"`). Use them for non-critical UI chrome - announcements or promotional content that does not require immediate attention.\n\n```html\n<mds-banner variant=\"dark\" tone=\"strong\" headline=\"Novita del mese\">\n <mds-text typography=\"detail\">\n Tre nuovi moduli sono stati aggiunti alla piattaforma.\n </mds-text>\n <mds-button slot=\"action\" variant=\"light\" tone=\"text\">Scopri</mds-button>\n</mds-banner>\n```\n\n#### AI Variant\n\nUse `variant=\"ai\"` to mark banners that present AI-generated content or AI-powered suggestions. The variant emits a polite `role=\"status\"` live announcement.\n\n```html\n<mds-banner variant=\"ai\" icon=\"mi/baseline/auto-awesome\" headline=\"Suggerimento IA\">\n <mds-text typography=\"detail\">\n L'analisi ha rilevato tre anomalie nel documento caricato.\n </mds-text>\n <mds-button slot=\"action\" variant=\"ai\" tone=\"outline\">Visualizza dettagli</mds-button>\n</mds-banner>\n```\n\n#### Dismissible Banner inside mds-modal\n\nWhen `dismissible` is set and the banner lives inside an `<mds-modal>`, activating the close button emits `mdsBannerClose` and also closes the modal automatically - no extra JavaScript needed.\n\n```html\n<mds-modal opened>\n <mds-banner variant=\"warning\" dismissible headline=\"Attenzione\">\n <mds-text typography=\"detail\">\n Stai per eliminare tutti i dati. L'azione non e reversibile.\n </mds-text>\n <mds-button slot=\"action\" variant=\"warning\" tone=\"outline\">Annulla</mds-button>\n <mds-button slot=\"action\" variant=\"warning\" tone=\"strong\">Elimina</mds-button>\n </mds-banner>\n</mds-modal>\n```\n\n#### CSS Custom Property Customization\n\nOverride appearance only through the public `--mds-banner-*` custom properties. Set them on the host or a parent selector; use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.featured-notice mds-banner {\n --mds-banner-background: rgb(var(--magma-accent-emphasis));\n --mds-banner-color: rgb(var(--magma-accent-on-emphasis));\n --mds-banner-radius: var(--magma-radius-sm);\n --mds-banner-shadow: 0 4px 16px rgb(var(--magma-shadow-ink) / 0.15);\n}\n```\n",
36
+ "3. Antipattern": "Common incorrect uses of `<mds-banner>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use an Invalid `tone` Value\n\n`mds-banner.tone` is typed as `ToneMinimalBoxVariantType`, which allows only `weak`, `strong`, and `box`. Values like `outline` or `text` are not accepted: no tone style matches them, so the banner renders as with `strong`, not with the `weak` default.\n\n```html\n<!-- INCORRECT -->\n<mds-banner variant=\"info\" tone=\"outline\">\n <mds-text typography=\"detail\">Informazione di sistema.</mds-text>\n</mds-banner>\n\n<!-- CORRECT -->\n<mds-banner variant=\"info\" tone=\"weak\">\n <mds-text typography=\"detail\">Informazione di sistema.</mds-text>\n</mds-banner>\n```\n\n#### Do Not Override the ARIA Role Manually\n\nThe component derives `role` and `aria-live` from `variant` (`error`/`warning` assertive, others polite) and writes them on the host when it renders, overwriting a manual value. To change the announcement, change the `variant`.\n\n```html\n<!-- INCORRECT -->\n<mds-banner variant=\"info\" role=\"alert\" aria-live=\"assertive\">\n <mds-text typography=\"detail\">Aggiornamento disponibile.</mds-text>\n</mds-banner>\n\n<!-- CORRECT - let variant drive the ARIA behavior -->\n<mds-banner variant=\"info\">\n <mds-text typography=\"detail\">Aggiornamento disponibile.</mds-text>\n</mds-banner>\n```\n\n#### Do Not Slot an `mds-button` into the Default Slot to Add Actions\n\nThe `action` named slot is the correct place for inline controls. Placing buttons in the default slot renders them inside the text region, breaks layout, and loses the flex wrapping the action row provides.\n\n```html\n<!-- INCORRECT -->\n<mds-banner variant=\"warning\">\n <mds-text typography=\"detail\">La licenza sta per scadere.</mds-text>\n <mds-button variant=\"warning\">Rinnova</mds-button>\n</mds-banner>\n\n<!-- CORRECT -->\n<mds-banner variant=\"warning\">\n <mds-text typography=\"detail\">La licenza sta per scadere.</mds-text>\n <mds-button slot=\"action\" variant=\"warning\" tone=\"strong\">Rinnova</mds-button>\n</mds-banner>\n```\n\n#### Do Not Set `dismissible=\"false\"` to Hide the Close Button\n\n`dismissible` is a boolean prop, and a false boolean is an absent attribute ([`agents/anti-patterns.md`](../../../../agents/anti-patterns.md)). Stencil reads the string `\"false\"` as `false` here, so the button is hidden, but the attribute stays on the element and any `[dismissible]` selector still matches it. Remove the attribute (or omit it) to hide the button.\n\n```html\n<!-- INCORRECT -->\n<mds-banner variant=\"error\" dismissible=\"false\">\n <mds-text typography=\"detail\">Errore permanente - non dismissibile.</mds-text>\n</mds-banner>\n\n<!-- CORRECT -->\n<mds-banner variant=\"error\">\n <mds-text typography=\"detail\">Errore permanente - non dismissibile.</mds-text>\n</mds-banner>\n```\n\n#### Do Not Use `dark` or `light` for Status Messages\n\n`variant=\"dark\"` and `variant=\"light\"` produce `role=\"presentation\"` with no live region - they are silent to assistive tech. Using them for error, warning, or informational content means screen reader users never receive the announcement.\n\n```html\n<!-- INCORRECT - errore silenzioso per tecnologie assistive -->\n<mds-banner variant=\"dark\">\n <mds-text typography=\"detail\">Errore: impossibile caricare il documento.</mds-text>\n</mds-banner>\n\n<!-- CORRECT -->\n<mds-banner variant=\"error\">\n <mds-text typography=\"detail\">Errore: impossibile caricare il documento.</mds-text>\n</mds-banner>\n```\n\n#### Do Not Pierce Shadow DOM to Style Internals\n\nThe only supported customization surface is the public `--mds-banner-*` CSS custom properties plus the `::part(text)` shadow part. Targeting internal class names with `>>>` or undocumented `::part()` names couples your code to the implementation and breaks on minor releases.\n\n```css\n/* INCORRECT */\nmds-banner >>> .headline {\n font-size: 1.5rem;\n}\nmds-banner::part(content) {\n padding: 0;\n}\n\n/* CORRECT */\nmds-banner {\n --mds-banner-radius: var(--magma-radius-sm);\n}\nmds-banner::part(text) {\n line-height: 1.6;\n}\n```\n\n#### Do Not Listen to the Native `click` Event for Dismissal\n\nThe component fires `mdsBannerClose` only when the close button is activated (both pointer and keyboard). A native `click` listener on the host fires for a click anywhere in the banner, body text and action buttons included.\n\n```html\n<!-- INCORRECT -->\n<mds-banner variant=\"info\" dismissible id=\"notice\">\n <mds-text typography=\"detail\">Avviso temporaneo.</mds-text>\n</mds-banner>\n<script>\n document.querySelector('#notice').addEventListener('click', () => {\n document.querySelector('#notice').remove();\n });\n</script>\n\n<!-- CORRECT -->\n<mds-banner variant=\"info\" dismissible id=\"notice\">\n <mds-text typography=\"detail\">Avviso temporaneo.</mds-text>\n</mds-banner>\n<script>\n document.querySelector('#notice').addEventListener('mdsBannerClose', () => {\n document.querySelector('#notice').remove();\n });\n</script>\n```\n"
36
37
  },
37
38
  "props": [
38
39
  {
@@ -46,7 +47,39 @@
46
47
  "mutable": false,
47
48
  "attr": "deletable",
48
49
  "reflectToAttr": false,
49
- "docs": "Shows the cross icon to perform cancel/delete action on element",
50
+ "docs": "Shows the close 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,
82
+ "docs": "Shows a close button that dismisses the banner: activating it emits `mdsBannerClose`",
50
83
  "docsTags": [],
51
84
  "values": [
52
85
  {
@@ -387,7 +420,8 @@
387
420
  "mds-policy-ai": [
388
421
  "mds-banner"
389
422
  ]
390
- }
423
+ },
424
+ "storybook": "ui-banner--docs"
391
425
  }
392
426
  ]
393
427
  }
@@ -118,17 +118,14 @@ mds-text {
118
118
  gap: var(--mds-banner-content-gap, --spacing(400));
119
119
  }
120
120
 
121
+ /* .body--dismissible: in a narrow banner the close button sits at the top right, and the first
122
+ * line keeps clear of it. A class, not the attribute of the host: dismissible and deletable are
123
+ * not reflected, a framework sets them as properties */
124
+
121
125
  @container mds-banner (max-width: 300px) {
122
- :host([deletable]:not([deletable='false'])) {
123
- & .headline {
124
- padding-right: --spacing(800);
125
- }
126
-
127
- &:host(:not([headline])) {
128
- & .content {
129
- padding-right: --spacing(800);
130
- }
131
- }
126
+ .body--dismissible .headline,
127
+ .body--dismissible .content:not(:has(.headline)) {
128
+ padding-right: --spacing(800);
132
129
  }
133
130
 
134
131
  ::slotted([slot='action']) {
@@ -46,9 +46,10 @@ export class MdsBanner {
46
46
  success: { role: 'status', live: 'polite' },
47
47
  warning: { role: 'alert', live: 'assertive' },
48
48
  };
49
- this.deletableHandler = () => {
49
+ this.isDismissible = () => this.dismissible === true || this.deletable === true;
50
+ this.dismissibleHandler = () => {
50
51
  var _a;
51
- if (this.deletable) {
52
+ if (this.isDismissible()) {
52
53
  const closeIcon = (_a = this.host.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector('.close-button');
53
54
  this.km.addElement(closeIcon);
54
55
  this.km.attachClickBehavior();
@@ -84,10 +85,10 @@ export class MdsBanner {
84
85
  this.setCloseButtonVariant(this.variant);
85
86
  }
86
87
  componentDidLoad() {
87
- this.deletableHandler();
88
+ this.dismissibleHandler();
88
89
  }
89
90
  componentDidUpdate() {
90
- this.deletableHandler();
91
+ this.dismissibleHandler();
91
92
  }
92
93
  disconnectedCallback() {
93
94
  this.km.detachClickBehavior();
@@ -97,7 +98,7 @@ export class MdsBanner {
97
98
  }
98
99
  render() {
99
100
  var _a, _b;
100
- return (h(Host, { key: '38e2261812c50298258f689158fd5aa89c8d9604', "aria-label": this.headline, role: this.ariaVariants[(_a = this.variant) !== null && _a !== void 0 ? _a : 'primary'].role, "aria-live": this.ariaVariants[(_b = this.variant) !== null && _b !== void 0 ? _b : 'primary'].live, "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: 'b827508e9566d3282e5c6becbc83cccdf837d5c0', class: "body" }, this.icon && h("mds-icon", { key: '50c27820fa631fa094337193ff2dad8b46bbadbc', "aria-hidden": "true", class: "icon", name: this.icon }), h("div", { key: 'e6f5e2478ef9b4d4e0ed428ddc573d770250b21e', class: "content" }, this.headline && (h("mds-text", { key: 'bd5a249e8108fe7b8a801c8137d123b3166ceb98', "aria-hidden": "true", class: "headline", typography: "h6" }, this.headline)), h("div", { key: '1e36faab19b706fa55d342d201d6e5f3e91973ab', class: "text", part: "text" }, h("slot", { key: '85dd2613a5f4f7de032143c099b4286374a4f765' }))), this.deletable && (h("mds-button", { key: 'e5bc724dd82fec4db5c4a36212245cd685e0c831', class: "close-button", icon: miBaselineClose, onClick: this.closeBanner, title: this.t.get('cancel'), variant: this.closeButtonVariant, tone: "text" }))), h("div", { key: '581e5ab175a7899780972d602904bb2f3f9a81e2', class: clsx('actions', !this.hasActions && 'actions--hidden') }, h("slot", { key: 'cb263fb11910ecff1368cccf63a36402823e0a7d', name: "action", onSlotchange: this.onActionSlotChange }))));
101
+ return (h(Host, { key: '278c0aca520ac2bedadf5a4ca96ad238826ec7b4', "aria-label": this.headline, role: this.ariaVariants[(_a = this.variant) !== null && _a !== void 0 ? _a : 'primary'].role, "aria-live": this.ariaVariants[(_b = this.variant) !== null && _b !== void 0 ? _b : 'primary'].live, "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: 'ce53b36682f67edea4cf91fe221bdb43bcbd88cf', class: clsx('body', this.isDismissible() && 'body--dismissible') }, this.icon && h("mds-icon", { key: '8f54ba530b5494e757654489d1a3cbb87f5a12f4', "aria-hidden": "true", class: "icon", name: this.icon }), h("div", { key: '1956316298c6b3c8fd0959f0d988b9ad9fd7382d', class: "content" }, this.headline && (h("mds-text", { key: 'aa0357e3334f6acb08650e59de1c0db3d0680ae0', "aria-hidden": "true", class: "headline", typography: "h6" }, this.headline)), h("div", { key: '0477620a9fd08ba6ca1b7290020923f1cf710e4d', class: "text", part: "text" }, h("slot", { key: 'e85c121336d692108485e45d0a350b4b3de44806' }))), this.isDismissible() && (h("mds-button", { key: 'c6a5496968f30240d2f9e092a9ee69fe0629ca1b', class: "close-button", icon: miBaselineClose, onClick: this.closeBanner, title: this.t.get('cancel'), variant: this.closeButtonVariant, tone: "text" }))), h("div", { key: 'b9076e0b13e98b2d017a09c8b0463c3a3db12c62', class: clsx('actions', !this.hasActions && 'actions--hidden') }, h("slot", { key: 'fe0bc615edc8bf1d9038703b02f070b455826cf8', name: "action", onSlotchange: this.onActionSlotChange }))));
101
102
  }
102
103
  static get is() { return "mds-banner"; }
103
104
  static get encapsulation() { return "shadow"; }
@@ -187,7 +188,7 @@ export class MdsBanner {
187
188
  "attribute": "hide-cockade",
188
189
  "defaultValue": "false"
189
190
  },
190
- "deletable": {
191
+ "dismissible": {
191
192
  "type": "boolean",
192
193
  "mutable": false,
193
194
  "complexType": {
@@ -199,7 +200,29 @@ export class MdsBanner {
199
200
  "optional": true,
200
201
  "docs": {
201
202
  "tags": [],
202
- "text": "Shows the cross icon to perform cancel/delete action on element"
203
+ "text": "Shows a close button that dismisses the banner: activating it emits `mdsBannerClose`"
204
+ },
205
+ "getter": false,
206
+ "setter": false,
207
+ "reflect": false,
208
+ "attribute": "dismissible"
209
+ },
210
+ "deletable": {
211
+ "type": "boolean",
212
+ "mutable": false,
213
+ "complexType": {
214
+ "original": "boolean",
215
+ "resolved": "boolean | undefined",
216
+ "references": {}
217
+ },
218
+ "required": false,
219
+ "optional": true,
220
+ "docs": {
221
+ "tags": [{
222
+ "name": "deprecated",
223
+ "text": "Use `dismissible`: the button dismisses the message, it deletes nothing.\nGoes in the next major."
224
+ }],
225
+ "text": "Shows the close button, as `dismissible` does."
203
226
  },
204
227
  "getter": false,
205
228
  "setter": false,
@@ -72,10 +72,10 @@ Set `icon` to a Magma icon slug. The icon is decorative (`aria-hidden="true"`).
72
72
 
73
73
  #### Dismissible Banner
74
74
 
75
- Set `deletable` to show a close button. The button emits `mdsBannerClose` when activated. Listen for the event to remove the banner from the DOM or update application state.
75
+ Set `dismissible` to show a close button. The button emits `mdsBannerClose` when activated. Listen for the event to remove the banner from the DOM or update application state.
76
76
 
77
77
  ```html
78
- <mds-banner variant="info" deletable id="promo-banner">
78
+ <mds-banner variant="info" dismissible id="promo-banner">
79
79
  <mds-text typography="detail">
80
80
  Scopri le nuove funzioni premium disponibili nel tuo piano.
81
81
  </mds-text>
@@ -147,11 +147,11 @@ Use `variant="ai"` to mark banners that present AI-generated content or AI-power
147
147
 
148
148
  #### Dismissible Banner inside mds-modal
149
149
 
150
- When `deletable` is set and the banner lives inside an `<mds-modal>`, activating the close button emits `mdsBannerClose` and also closes the modal automatically - no extra JavaScript needed.
150
+ When `dismissible` is set and the banner lives inside an `<mds-modal>`, activating the close button emits `mdsBannerClose` and also closes the modal automatically - no extra JavaScript needed.
151
151
 
152
152
  ```html
153
153
  <mds-modal opened>
154
- <mds-banner variant="warning" deletable headline="Attenzione">
154
+ <mds-banner variant="warning" dismissible headline="Attenzione">
155
155
  <mds-text typography="detail">
156
156
  Stai per eliminare tutti i dati. L'azione non e reversibile.
157
157
  </mds-text>
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-benchmark-bar
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-benchmark-bar>` web component is a read-only data-visualization element of the Magma Design System that pairs a labelled caption with a horizontal progress bar to express a single benchmark value on a 0-100 scale. It is a presentational compound that composes `<mds-text>` and `<mds-progress>`; it has no native HTML primitive equivalent.
12
12
 
@@ -29,6 +29,7 @@ The shared `variant` and `size` ladders are defined in [`agents/variants.md`](..
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-benchmark-bar--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-benchmark-bar/mds-benchmark-bar.tsx",
@@ -311,7 +312,8 @@
311
312
  "mds-icon",
312
313
  "mds-text"
313
314
  ]
314
- }
315
+ },
316
+ "storybook": "ui-benchmark-bar--docs"
315
317
  }
316
318
  ]
317
319
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-bibliography
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-bibliography>` web component renders a single citation entry formatted according to a recognized academic style. It is a presentational component that takes structured metadata (author, title, publisher, date, location, URL) and composes it into a styled, correctly-punctuated reference line, replacing the manual assembly of a bibliography string.
12
12
 
@@ -31,6 +31,7 @@ The `<mds-bibliography>` web component renders a single citation entry formatted
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-bibliography--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-bibliography/mds-bibliography.tsx",
@@ -418,7 +419,8 @@
418
419
  "mds-bibliography": [
419
420
  "mds-text"
420
421
  ]
421
- }
422
+ },
423
+ "storybook": "ui-bibliography--docs"
422
424
  }
423
425
  ]
424
426
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-book
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-book>` web component shows a book as a physical object, from the image of its front cover alone: front cover, spine and page block drawn in CSS 3D, turned a little so the spine shows. It is the catalogue and product-page counterpart of `<mds-img>`, for publications rather than pictures.
12
12
 
@@ -14,7 +14,7 @@ The `<mds-book>` web component shows a book as a physical object, from the image
14
14
 
15
15
  - **One image of the book**: The host is a single `role="img"` named by `alt`, or by `name` and `author` ("Title by Author", localised in el/en/es/it), or by a generic "Book" when there is neither. An empty `alt` marks the book as decorative (`role="presentation"`). The text printed on the spine and on a drawn cover is hidden from assistive technologies, since it repeats that name.
16
16
  - **The sides come from the cover**: The spine continues the left edge of the cover image and the board edges its top and right edges, as a wraparound cover prints its design on, so no spine or back cover image is needed. Without an image they take `--mds-book-color`.
17
- - **A drawn cover instead of a broken image**: Without `src`, or when the image fails to load, the front shows the title, the author and the publisher on `--mds-book-color`. A new `src` tries again.
17
+ - **A drawn cover instead of a broken image**: Without `src`, or when the image fails to load, the front shows the author, the title and the publisher, or its mark, on `--mds-book-color`. A new `src` tries again.
18
18
  - **A neutral shape while loading**: Until its image arrives, a book with `src` is drawn in a neutral surface colour, so a lazy catalogue does not flash in the colour of drawn covers.
19
19
  - **Light and shadow**: The book is seen a little from above. Each face takes the light by how it turns toward it, in a light touch that shows the volume without drawing the eye. Its shadow falls on the surface it rests on, under its tail when it stands and under its back cover when it lies, darkest where it touches and soon gone; around its outline only a halo faint enough to part a light cover from a light page.
20
20
  - **Movement**: The book rests in its `pose`. On hover it rises off the surface, its shadow fading there, and leans a little toward the pointer, with a faint sheen on the cover. A drag (mouse, pen or finger) turns it further, within limits, to show the spine or the pages, never the back, or spins a lying book on its surface; it settles back when released, or when the pointer leaves the window or the frame of the page, where its release could not reach the book. A vertical swipe still scrolls the page.
@@ -39,12 +39,15 @@ The `<mds-book>` web component shows a book as a physical object, from the image
39
39
  - `'paperback'`: cut flush, the cover a hairline on the same edge as the pages, a flat spine.
40
40
  - `'hardcover'`: rigid boards about 2.5 mm thick, overhanging a page block set in from them by about 3 mm, the endpapers showing in the gap, a headband, a rounded spine and a hinge groove on the front.
41
41
  - **`name`**, **`author`**, **`publisher`**: the same names as on `<mds-bibliography>`, so one catalogue record feeds both.
42
+ - **The spine**: the title, then the author, at the head, and the publisher at the foot. Where the spine has room for two lines, at least 13.5% as deep as the book is wide (about 23 mm on a 17x24, some 270 pages in paperback), the author goes under the title, smaller, as on a thick volume.
43
+ - **`publisher-logo`**: the mark of the publisher, printed instead of its name at the foot of the spine and of a drawn cover (a cover image carries its own). Only its shape is printed, as a mask, in `--mds-book-publisher-color`, which is the colour of the text unless set, so a mark of any colour prints in the ink of the book. Give an svg, or a png on a transparent ground; an image from another origin needs CORS headers, as any mask does. The place stays empty while the mark loads, and the name of the publisher is printed if it fails.
42
44
  - **Size**: the book is sized as an image is, in the proportions of its format: give it a width, and its height follows; give it a height, and its width follows. With neither, it fills the width of its container, as a block does; where nothing gives it a width (a row of a flex layout) it is 200 px wide. Its box is the front cover at rest: the turned book reaches a little beyond it, by a few percent of its width on each side standing, by up to a third lying spun round, so leave it some room inside a container that clips.
43
45
 
44
46
  ## Read next
45
47
 
46
48
  - [`pattern.md`](pattern.md) - correct usage, with examples
47
49
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
50
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-book--docs) - the live examples, in the published Storybook of `main`
48
51
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
49
52
 
50
53
  ## Props
@@ -52,14 +55,15 @@ The `<mds-book>` web component shows a book as a physical object, from the image
52
55
  | Prop | Attribute | Type | Default | Description |
53
56
  | --- | --- | --- | --- | --- |
54
57
  | `alt` | `alt` | `string \| undefined` | - | The accessible name of the book. Without it the name is built from `name` and `author`; an empty `alt` marks the book as decorative, left out by assistive technologies |
55
- | `author` | `author` | `string \| undefined` | - | The author, printed on the spine and on the cover drawn when there is no image |
58
+ | `author` | `author` | `string \| undefined` | - | The author, printed on the cover drawn when there is no image, above the title, and on the spine after the title, or under it where the spine has room for two lines |
56
59
  | `binding` | `binding` | `"hardcover" \| "paperback"` | `'paperback'` | How the book is bound: a thin flexible cover flush with the pages, or rigid boards a little larger than the page block, with a rounded spine |
57
60
  | `format` | `format` | `"a4" \| "a5" \| "auto" \| "b5" \| '${number}x${number}'` | `'auto'` | The proportions of the book. `auto` takes them from the image; a named format (`a4`, `a5`, `b5`) is portrait; any other one is `WxH` in centimetres, the order of the two numbers being the orientation (`17x24` portrait, `24x17` landscape, `21x21` square) |
58
61
  | `loading` | `loading` | `"eager" \| "lazy" \| undefined` | `'lazy'` | Specifies whether a browser should load the cover immediately or defer it until it is near the viewport |
59
62
  | `name` | `name` | `string \| undefined` | - | The title of the book, printed on the spine and on the cover drawn when there is no image |
60
63
  | `pages` | `pages` | `number` | `300` | The number of pages, which sets how deep the book is, against the width of its format (17 cm for `auto`). A page is as thick as `--mds-book-page-weight-min` at 1 page, going to `--mds-book-page-weight-max` at 1000 pages and more, in proportion: by default from 0.1 mm, the bulky paper of a short book, to 0.05 mm, the thin paper of a volume, so 64 pages make 6 mm, 300 pages 2.5 cm and 1000 pages 5 cm. A spine under 5 mm deep carries no text |
61
64
  | `pose` | `pose` | `"fore-edge" \| "front" \| "lying" \| "lying-turned" \| "spine"` | `'spine'` | How the book is shown: standing, turned to show its spine (`spine`) or its pages (`fore-edge`), or facing the reader (`front`); lying on its back, seen from above, its tail toward the reader (`lying`) or spun on the surface (`lying-turned`). A drag turns it from there, and it goes back when released |
62
- | `publisher` | `publisher` | `string \| undefined` | - | The publisher, printed at the foot of the spine and of the cover drawn when there is no image |
65
+ | `publisher` | `publisher` | `string \| undefined` | - | The publisher, printed at the foot of the spine and of the cover drawn when there is no image, unless its `publisher-logo` is printed there instead |
66
+ | `publisherLogo` | `publisher-logo` | `string \| undefined` | - | The mark of the publisher, printed instead of its name at the foot of the spine and of the cover drawn when there is no image: the path to an svg, or a png on a transparent ground. Its shape is printed, not its colours, in `--mds-book-publisher-color`. An image from another origin needs CORS headers, as any mask does; one that does not load leaves the name |
63
67
  | `src` | `src` | `string \| undefined` | - | Specifies the path to the image of the front cover |
64
68
 
65
69
  ## Parts
@@ -73,6 +77,7 @@ The `<mds-book>` web component shows a book as a physical object, from the image
73
77
  | Property | Description |
74
78
  | --- | --- |
75
79
  | `--mds-book-color` | **Static**: a value of its own, not a token or a role. The colour of the binding where the cover image cannot continue: the spine and the board edges without an image, and the cover drawn when there is no image. |
80
+ | `--mds-book-publisher-color` | **Static**: a value of its own, not a token or a role. The colour of the publisher at the foot of the spine and of the cover drawn when there is no image, its mark or its name. Unset, the colour of the text. |
76
81
  | `--mds-book-spine-color` | **Static**: a value of its own, not a token or a role. A solid colour for the spine and the board edges. Unset, they continue the edges of the cover image. |
77
82
  | `--mds-book-text-color` | **Static**: a value of its own, not a token or a role. The colour of the text on the spine and on the cover drawn when there is no image. |
78
83