@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-book/mds-book.tsx",
@@ -22,8 +23,8 @@
22
23
  }
23
24
  ],
24
25
  "usage": {
25
- "1. Description": "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.\n\n#### Semantic Behavior\n\n- **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.\n- **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`.\n- **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.\n- **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.\n- **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.\n- **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.\n- **Not a control**: The book has no action of its own. To make it a link, wrap it: the click that ends a drag does not follow the link, a plain click does.\n- **Reduced motion**: With the animation preference set to reduce (or the system asking for it, when there is no controller), the book keeps its resting pose: no lean, no lift, no drag.\n- **Consumption**: The consumption preference sets how much the book costs to draw. At `high` (the default, and on a page without the controller) it does everything; at `medium` it moves without the sheen and without the halo, a filter computed again on every frame; at `low` it is drawn once, in its pose, and never animated. While it moves, only opacities and transforms change, which the compositor applies without painting the faces again.\n\n#### Properties & Visual Configurations\n\n- **`pose`**: how the book is shown, after the usual shots of product photography. A drag turns it from there, and it goes back to it when released.\n - `'spine'`: standing, turned to show its spine; the default, and the one for a catalogue.\n - `'fore-edge'`: standing, turned the other way to show its pages.\n - `'front'`: facing the reader, flat, the cover as it is; the light still shows the binding when it moves.\n - `'lying'`: lying on its back, seen from above, its tail toward the reader: a book on a desk.\n - `'lying-turned'`: lying, spun on the surface to show its spine and its tail.\n\n- **`format`**: the proportions of the book, in one field that also carries the orientation.\n - `'auto'`: the proportions of the image, read once it has loaded (a square cover gives a square book); before that, and without an image, 17x24. Pick it when the image already has the true proportions.\n - `'a4'`, `'a5'`, `'b5'`: the ISO formats, portrait. Any other format is `WxH` in centimetres, the order of the two numbers being the orientation: `'17x24'` portrait, `'24x17'` landscape, `'21x21'` square. A fixed format keeps its shape before the image loads and crops small differences of the image.\n- **`pages`**: the number of pages, from the catalogue record, which sets how deep the book is against the width of its format (17 cm for `'auto'`). A short book is printed on bulky paper and a long volume on thin paper, so a page goes from 0.1 mm at 1 page to 0.05 mm at 1000 pages and beyond, in proportion: 64 pages make 6 mm, 300 pages 2.5 cm, 1000 pages 5 cm, and an A4 of the same pages looks thinner than a 17x24. A spine under 5 mm carries no text.\n- **`binding`**: how the book is built, which shows on its head, its fore edge and its spine.\n - `'paperback'`: cut flush, the cover a hairline on the same edge as the pages, a flat spine.\n - `'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.\n- **`name`**, **`author`**, **`publisher`**: the same names as on `<mds-bibliography>`, so one catalogue record feeds both.\n- **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.\n",
26
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-book>` 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#### A Book from Its Cover\n\nThe canonical form: the cover image and the catalogue data. The title and the author name the book for assistive technologies and are printed on the spine.\n\n```html\n<mds-book\n src=\"/covers/operazioni-straordinarie.webp\"\n name=\"Operazioni straordinarie\"\n author=\"Antonio D'Amico e Sara Orlando\"\n publisher=\"Maggioli Editore\"\n></mds-book>\n```\n\n#### Pages and Binding from the Catalogue Record\n\nPass the page count and the binding of the record as they are: the book takes its true depth, so a booklet and a large manual do not look alike.\n\n```html\n<mds-book src=\"/covers/guida-rapida.webp\" name=\"Guida rapida al GDPR\" pages=\"64\"></mds-book>\n\n<mds-book\n src=\"/covers/codice-appalti.webp\"\n name=\"Codice dei contratti pubblici\"\n pages=\"1000\"\n binding=\"hardcover\"\n></mds-book>\n```\n\n#### A Catalogue Grid\n\nThe book takes the width of its cell. Give the grid some gap: the turned books reach a little beyond their boxes.\n\n```html\n<div class=\"grid grid-cols-4 gap-1200\">\n <mds-book src=\"/covers/1.webp\" name=\"Creare la holding\" author=\"Ennio Vial\"></mds-book>\n <mds-book src=\"/covers/2.webp\" name=\"Chief AI Officer\" pages=\"480\"></mds-book>\n <mds-book src=\"/covers/3.webp\" name=\"Aste immobiliari e vendita forzata\"></mds-book>\n <mds-book src=\"/covers/4.webp\" name=\"Agenda dei servizi demografici 2027\"></mds-book>\n</div>\n```\n\n#### A Pose for the Layout\n\nPick the pose that suits where the book sits: `spine` in a catalogue, `front` beside a description, `lying` or `lying-turned` for a book on a desk in a hero or a banner.\n\n```html\n<mds-book src=\"/covers/manuale.webp\" name=\"Manuale\" pose=\"front\"></mds-book>\n\n<mds-book\n src=\"/covers/codice-appalti.webp\"\n name=\"Codice dei contratti pubblici\"\n binding=\"hardcover\"\n pages=\"640\"\n pose=\"lying-turned\"\n></mds-book>\n```\n\n#### A Fixed Format\n\nWith `format=\"auto\"` (the default) the book takes the proportions of its image once it loads. Set the format when the catalogue knows it, so the book has its shape before the image arrives; write any format as `WxH` in centimetres, the width first.\n\n```html\n<mds-book src=\"/covers/modulistica.webp\" name=\"Modulistica\" format=\"a4\"></mds-book>\n\n<mds-book src=\"/covers/atlante.webp\" name=\"Atlante dei comuni\" format=\"29.7x21\"></mds-book>\n```\n\n#### A Book Without a Cover Image\n\nWithout `src`, the component draws a cover with the title, the author and the publisher. Give it the colour of the series.\n\n```html\n<mds-book\n name=\"Agenda dei servizi demografici 2027\"\n publisher=\"Maggioli Editore\"\n style=\"--mds-book-color: #f2a93b; --mds-book-text-color: #ffffff\"\n></mds-book>\n```\n\n#### A Solid Spine\n\nWhen the left edge of the cover does not continue well onto the spine (a photo, a thin white border), give the spine and the board edges a colour of their own.\n\n```html\n<mds-book\n src=\"/covers/manuale.webp\"\n name=\"Manuale\"\n style=\"--mds-book-spine-color: #123a6b\"\n></mds-book>\n```\n\n#### A Book That Opens Its Product Page\n\nThe book is an image, not a control: wrap it in a link, with the link named by the book. Turning the book with a drag does not open the link; a click does.\n\n```html\n<a href=\"/catalogo/creare-la-holding\">\n <mds-book src=\"/covers/creare-la-holding.webp\" name=\"Creare la holding\" author=\"Ennio Vial\"></mds-book>\n</a>\n```\n",
26
+ "1. Description": "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.\n\n#### Semantic Behavior\n\n- **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.\n- **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`.\n- **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.\n- **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.\n- **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.\n- **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.\n- **Not a control**: The book has no action of its own. To make it a link, wrap it: the click that ends a drag does not follow the link, a plain click does.\n- **Reduced motion**: With the animation preference set to reduce (or the system asking for it, when there is no controller), the book keeps its resting pose: no lean, no lift, no drag.\n- **Consumption**: The consumption preference sets how much the book costs to draw. At `high` (the default, and on a page without the controller) it does everything; at `medium` it moves without the sheen and without the halo, a filter computed again on every frame; at `low` it is drawn once, in its pose, and never animated. While it moves, only opacities and transforms change, which the compositor applies without painting the faces again.\n\n#### Properties & Visual Configurations\n\n- **`pose`**: how the book is shown, after the usual shots of product photography. A drag turns it from there, and it goes back to it when released.\n - `'spine'`: standing, turned to show its spine; the default, and the one for a catalogue.\n - `'fore-edge'`: standing, turned the other way to show its pages.\n - `'front'`: facing the reader, flat, the cover as it is; the light still shows the binding when it moves.\n - `'lying'`: lying on its back, seen from above, its tail toward the reader: a book on a desk.\n - `'lying-turned'`: lying, spun on the surface to show its spine and its tail.\n\n- **`format`**: the proportions of the book, in one field that also carries the orientation.\n - `'auto'`: the proportions of the image, read once it has loaded (a square cover gives a square book); before that, and without an image, 17x24. Pick it when the image already has the true proportions.\n - `'a4'`, `'a5'`, `'b5'`: the ISO formats, portrait. Any other format is `WxH` in centimetres, the order of the two numbers being the orientation: `'17x24'` portrait, `'24x17'` landscape, `'21x21'` square. A fixed format keeps its shape before the image loads and crops small differences of the image.\n- **`pages`**: the number of pages, from the catalogue record, which sets how deep the book is against the width of its format (17 cm for `'auto'`). A short book is printed on bulky paper and a long volume on thin paper, so a page goes from 0.1 mm at 1 page to 0.05 mm at 1000 pages and beyond, in proportion: 64 pages make 6 mm, 300 pages 2.5 cm, 1000 pages 5 cm, and an A4 of the same pages looks thinner than a 17x24. A spine under 5 mm carries no text.\n- **`binding`**: how the book is built, which shows on its head, its fore edge and its spine.\n - `'paperback'`: cut flush, the cover a hairline on the same edge as the pages, a flat spine.\n - `'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.\n- **`name`**, **`author`**, **`publisher`**: the same names as on `<mds-bibliography>`, so one catalogue record feeds both.\n- **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.\n- **`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.\n- **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.\n",
27
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-book>` 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#### A Book from Its Cover\n\nThe canonical form: the cover image and the catalogue data. The title and the author name the book for assistive technologies and are printed on the spine.\n\n```html\n<mds-book\n src=\"/covers/operazioni-straordinarie.webp\"\n name=\"Operazioni straordinarie\"\n author=\"Antonio D'Amico e Sara Orlando\"\n publisher=\"Maggioli Editore\"\n></mds-book>\n```\n\n#### Pages and Binding from the Catalogue Record\n\nPass the page count and the binding of the record as they are: the book takes its true depth, so a booklet and a large manual do not look alike.\n\n```html\n<mds-book src=\"/covers/guida-rapida.webp\" name=\"Guida rapida al GDPR\" pages=\"64\"></mds-book>\n\n<mds-book\n src=\"/covers/codice-appalti.webp\"\n name=\"Codice dei contratti pubblici\"\n pages=\"1000\"\n binding=\"hardcover\"\n></mds-book>\n```\n\n#### A Catalogue Grid\n\nThe book takes the width of its cell. Give the grid some gap: the turned books reach a little beyond their boxes.\n\n```html\n<div class=\"grid grid-cols-4 gap-1200\">\n <mds-book src=\"/covers/1.webp\" name=\"Creare la holding\" author=\"Ennio Vial\"></mds-book>\n <mds-book src=\"/covers/2.webp\" name=\"Chief AI Officer\" pages=\"480\"></mds-book>\n <mds-book src=\"/covers/3.webp\" name=\"Aste immobiliari e vendita forzata\"></mds-book>\n <mds-book src=\"/covers/4.webp\" name=\"Agenda dei servizi demografici 2027\"></mds-book>\n</div>\n```\n\n#### A Pose for the Layout\n\nPick the pose that suits where the book sits: `spine` in a catalogue, `front` beside a description, `lying` or `lying-turned` for a book on a desk in a hero or a banner.\n\n```html\n<mds-book src=\"/covers/manuale.webp\" name=\"Manuale\" pose=\"front\"></mds-book>\n\n<mds-book\n src=\"/covers/codice-appalti.webp\"\n name=\"Codice dei contratti pubblici\"\n binding=\"hardcover\"\n pages=\"640\"\n pose=\"lying-turned\"\n></mds-book>\n```\n\n#### A Fixed Format\n\nWith `format=\"auto\"` (the default) the book takes the proportions of its image once it loads. Set the format when the catalogue knows it, so the book has its shape before the image arrives; write any format as `WxH` in centimetres, the width first.\n\n```html\n<mds-book src=\"/covers/modulistica.webp\" name=\"Modulistica\" format=\"a4\"></mds-book>\n\n<mds-book src=\"/covers/atlante.webp\" name=\"Atlante dei comuni\" format=\"29.7x21\"></mds-book>\n```\n\n#### A Book Without a Cover Image\n\nWithout `src`, the component draws a cover with the title, the author and the publisher. Give it the colour of the series.\n\n```html\n<mds-book\n name=\"Agenda dei servizi demografici 2027\"\n publisher=\"Maggioli Editore\"\n style=\"--mds-book-color: #f2a93b; --mds-book-text-color: #ffffff\"\n></mds-book>\n```\n\n#### The Mark of the Publisher\n\nGive the mark of the publisher instead of printing its name: it goes at the foot of the spine, and of the cover when the component draws it. Its shape is printed in the colour of the text, or in `--mds-book-publisher-color`; keep `publisher`, printed if the mark does not load.\n\n```html\n<mds-book\n name=\"Agenda dei servizi demografici 2027\"\n author=\"Redazione Maggioli\"\n publisher=\"Maggioli Editore\"\n publisher-logo=\"/logos/maggioli-editore.svg\"\n style=\"--mds-book-color: #f2a93b; --mds-book-text-color: #ffffff\"\n></mds-book>\n```\n\n#### A Solid Spine\n\nWhen the left edge of the cover does not continue well onto the spine (a photo, a thin white border), give the spine and the board edges a colour of their own.\n\n```html\n<mds-book\n src=\"/covers/manuale.webp\"\n name=\"Manuale\"\n style=\"--mds-book-spine-color: #123a6b\"\n></mds-book>\n```\n\n#### A Book That Opens Its Product Page\n\nThe book is an image, not a control: wrap it in a link, with the link named by the book. Turning the book with a drag does not open the link; a click does.\n\n```html\n<a href=\"/catalogo/creare-la-holding\">\n <mds-book src=\"/covers/creare-la-holding.webp\" name=\"Creare la holding\" author=\"Ennio Vial\"></mds-book>\n</a>\n```\n",
27
28
  "3. Antipattern": "Common incorrect uses of `<mds-book>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use the `title` Attribute for the Title\n\n`title` is the native tooltip of every element: it shows a tooltip and prints nothing on the book. The title of the book is `name`.\n\n```html\n<!-- INCORRECT -->\n<mds-book src=\"/covers/manuale.webp\" title=\"Manuale\"></mds-book>\n\n<!-- CORRECT -->\n<mds-book src=\"/covers/manuale.webp\" name=\"Manuale\"></mds-book>\n```\n\n#### Do Not Draw the 3D With `<mds-img>` and CSS Transforms\n\nA transformed `<mds-img>` is a tilted flat picture: no spine, no pages, no drawn cover when the image fails, no reduced-motion handling.\n\n```html\n<!-- INCORRECT -->\n<mds-img src=\"/covers/manuale.webp\" alt=\"Manuale\" style=\"transform: perspective(600px) rotateY(25deg)\"></mds-img>\n\n<!-- CORRECT -->\n<mds-book src=\"/covers/manuale.webp\" name=\"Manuale\"></mds-book>\n```\n\n#### Do Not Turn the Book With a Transform\n\nA transform on the host turns the flat box the book is drawn in: the light on the faces, the shadow and the drag still work from the pose, which no longer matches. Pick a `pose`.\n\n```html\n<!-- INCORRECT -->\n<mds-book src=\"/covers/manuale.webp\" name=\"Manuale\" style=\"transform: rotateX(60deg)\"></mds-book>\n\n<!-- CORRECT -->\n<mds-book src=\"/covers/manuale.webp\" name=\"Manuale\" pose=\"lying\"></mds-book>\n```\n\n#### Do Not Set Both a Width and a Height\n\nThe book keeps the proportions of its format, as an image does: one dimension sets the other. Two that disagree leave the book as wide as its box and the box with a gap or an overflow.\n\n```html\n<!-- INCORRECT -->\n<mds-book src=\"/covers/manuale.webp\" name=\"Manuale\" style=\"width: 220px; height: 220px\"></mds-book>\n\n<!-- CORRECT -->\n<mds-book src=\"/covers/manuale.webp\" name=\"Manuale\" style=\"height: 320px\"></mds-book>\n```\n\n#### Do Not Write a Landscape Format as a Separate Orientation\n\nThere is no orientation prop: the order of the two numbers of `format` is the orientation.\n\n```html\n<!-- INCORRECT -->\n<mds-book name=\"Atlante\" format=\"a4\" orientation=\"landscape\"></mds-book>\n\n<!-- CORRECT -->\n<mds-book name=\"Atlante\" format=\"29.7x21\"></mds-book>\n```\n\n#### Do Not Repeat the Name Next to the Book for Assistive Technologies\n\nThe book is already named after `name` and `author`. A visible caption that repeats them makes screen readers read the title twice: mark the book decorative with `alt=\"\"` when a caption names it.\n\n```html\n<!-- INCORRECT -->\n<figure>\n <mds-book src=\"/covers/manuale.webp\" name=\"Manuale\"></mds-book>\n <figcaption>Manuale</figcaption>\n</figure>\n\n<!-- CORRECT -->\n<figure>\n <mds-book src=\"/covers/manuale.webp\" name=\"Manuale\" alt=\"\"></mds-book>\n <figcaption>Manuale</figcaption>\n</figure>\n```\n"
28
29
  },
29
30
  "props": [
@@ -64,7 +65,7 @@
64
65
  "mutable": false,
65
66
  "attr": "author",
66
67
  "reflectToAttr": false,
67
- "docs": "The author, printed on the spine and on the cover drawn when there is no image",
68
+ "docs": "The author, printed on the cover drawn when there is no image, above the title, and on the\nspine after the title, or under it where the spine has room for two lines",
68
69
  "docsTags": [],
69
70
  "values": [
70
71
  {
@@ -339,7 +340,7 @@
339
340
  "mutable": false,
340
341
  "attr": "publisher",
341
342
  "reflectToAttr": false,
342
- "docs": "The publisher, printed at the foot of the spine and of the cover drawn when there is no image",
343
+ "docs": "The publisher, printed at the foot of the spine and of the cover drawn when there is no\nimage, unless its `publisher-logo` is printed there instead",
343
344
  "docsTags": [],
344
345
  "values": [
345
346
  {
@@ -354,6 +355,37 @@
354
355
  "getter": false,
355
356
  "setter": false
356
357
  },
358
+ {
359
+ "name": "publisherLogo",
360
+ "type": "string | undefined",
361
+ "complexType": {
362
+ "original": "string",
363
+ "resolved": "string | undefined",
364
+ "references": {}
365
+ },
366
+ "mutable": false,
367
+ "attr": "publisher-logo",
368
+ "reflectToAttr": false,
369
+ "docs": "The mark of the publisher, printed instead of its name at the foot of the spine and of the\ncover drawn when there is no image: the path to an svg, or a png on a transparent ground.\nIts shape is printed, not its colours, in `--mds-book-publisher-color`. An image from\nanother origin needs CORS headers, as any mask does; one that does not load leaves the name",
370
+ "docsTags": [
371
+ {
372
+ "name": "example",
373
+ "text": "'/logos/maggioli-editore.svg'"
374
+ }
375
+ ],
376
+ "values": [
377
+ {
378
+ "type": "string"
379
+ },
380
+ {
381
+ "type": "undefined"
382
+ }
383
+ ],
384
+ "optional": true,
385
+ "required": false,
386
+ "getter": false,
387
+ "setter": false
388
+ },
357
389
  {
358
390
  "name": "src",
359
391
  "type": "string | undefined",
@@ -451,6 +483,13 @@
451
483
  "docs": "The colour of the page block.",
452
484
  "visibility": "internal"
453
485
  },
486
+ {
487
+ "name": "--mds-book-publisher-color",
488
+ "annotation": "prop",
489
+ "docs": "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.",
490
+ "visibility": "public",
491
+ "static": true
492
+ },
454
493
  {
455
494
  "name": "--mds-book-spine-color",
456
495
  "annotation": "prop",
@@ -476,7 +515,8 @@
476
515
  "states": [],
477
516
  "dependents": [],
478
517
  "dependencies": [],
479
- "dependencyGraph": {}
518
+ "dependencyGraph": {},
519
+ "storybook": "ui-book--docs"
480
520
  }
481
521
  ]
482
522
  }
@@ -98,6 +98,7 @@
98
98
  * @prop --mds-book-page-weight-max: The thickness of a page, in millimetres (a number), on a book of 1000 pages and more: the thin paper of a volume.
99
99
  * @prop --mds-book-page-weight-min: The thickness of a page, in millimetres (a number), on a book of 1 page; between 1 and 1000 pages it goes to --mds-book-page-weight-max in proportion.
100
100
  * @prop --mds-book-paper-color: The colour of the page block.
101
+ * @prop --mds-book-publisher-color: Public, static. 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.
101
102
  * @prop --mds-book-spine-color: Public, static. A solid colour for the spine and the board edges. Unset, they continue the edges of the cover image.
102
103
  * @prop --mds-book-text-color: Public, static. The colour of the text on the spine and on the cover drawn when there is no image.
103
104
  */
@@ -108,6 +109,7 @@
108
109
  /* stylelint-disable-next-line magma/token-values -- paper, the one colour of the physical object that no role says: it stays paper in dark mode, as the cover image stays the same picture */
109
110
  --mds-book-paper-color: rgb(250 248 242);
110
111
  --mds-book-text-color: rgb(var(--magma-accent-on-emphasis, var(--tone-neutral-seed, 255 255 255)));
112
+ --mds-book-publisher-color: var(--mds-book-text-color, rgb(var(--magma-accent-on-emphasis, var(--tone-neutral-seed, 255 255 255))));
111
113
 
112
114
  /* the thickness of a page, in millimetres: the bulky paper of a short book, the thin paper
113
115
  of a volume of 1000 pages and more */
@@ -142,11 +144,11 @@
142
144
  display: block;
143
145
 
144
146
  /* the width a height gives it wins over the natural width below, which would otherwise be
145
- its least width */
147
+ its least width */
146
148
  min-width: 0;
147
149
 
148
150
  /* a vertical swipe still scrolls the page, a horizontal one turns the book; Safari ignores
149
- it, and may take a horizontal drag of a finger for the page */
151
+ it, and may take a horizontal drag of a finger for the page */
150
152
 
151
153
  /* stylelint-disable-next-line plugin/no-unsupported-browser-features -- see above */
152
154
  touch-action: pan-y;
@@ -451,7 +453,10 @@
451
453
  width: 100%;
452
454
  }
453
455
 
456
+ /* its padding inside the cover, or the publisher at its foot falls off the bottom edge */
457
+
454
458
  .drawn-cover {
459
+ box-sizing: border-box;
455
460
  color: var(--mds-book-text-color, rgb(var(--magma-accent-on-emphasis, var(--tone-neutral-seed, 255 255 255))));
456
461
  display: flex;
457
462
  flex-direction: column;
@@ -465,8 +470,12 @@
465
470
  line-height: 1.2;
466
471
  }
467
472
 
473
+ /* The title is set as the titles of Magma are (text-title-h1 to h5, and mds-text): their face
474
+ and weight. Its size stays the book's, a share of its width, which no text-title utility
475
+ gives. */
476
+
468
477
  .drawn-name {
469
- @apply font-bold;
478
+ @apply antialiased font-black font-title;
470
479
 
471
480
  -webkit-box-orient: vertical;
472
481
  display: -webkit-box;
@@ -478,9 +487,39 @@
478
487
  overflow-wrap: anywhere;
479
488
  }
480
489
 
490
+ .drawn-publisher,
491
+ .drawn-logo {
492
+ margin-top: auto;
493
+ }
494
+
481
495
  .drawn-publisher {
496
+ color: var(--mds-book-publisher-color, rgb(var(--magma-accent-on-emphasis, var(--tone-neutral-seed, 255 255 255))));
482
497
  font-size: 4.5cqi;
483
- margin-top: auto;
498
+ }
499
+
500
+ /* The mark of the publisher is the shape of its image, a mask filled with the colour of the
501
+ publisher, so a mark of any colour prints in the ink of the book. Its box is the most it
502
+ takes: the mark keeps its proportions inside, at the foot. */
503
+
504
+ .drawn-logo,
505
+ .spine-logo {
506
+ background-color: var(--mds-book-publisher-color, rgb(var(--magma-accent-on-emphasis, var(--tone-neutral-seed, 255 255 255))));
507
+ flex-shrink: 0;
508
+ -webkit-mask-image: var(--private-book-logo);
509
+ mask-image: var(--private-book-logo);
510
+ -webkit-mask-repeat: no-repeat;
511
+ mask-repeat: no-repeat;
512
+ -webkit-mask-size: contain;
513
+ mask-size: contain;
514
+ }
515
+
516
+ /* on the cover, under the text and aligned with it */
517
+
518
+ .drawn-logo {
519
+ height: 15cqi;
520
+ -webkit-mask-position: left bottom;
521
+ mask-position: left bottom;
522
+ width: 50cqi;
484
523
  }
485
524
 
486
525
  /* The faces made of the cover material: the board edges, the slats of a rounded spine and
@@ -774,6 +813,9 @@
774
813
  .spine,
775
814
  .spine-label {
776
815
  box-sizing: border-box;
816
+
817
+ /* what the text asks whether two lines fit across the spine (see .spine-text) */
818
+ container-type: inline-size;
777
819
  display: flex;
778
820
 
779
821
  /* the lengths of the text are set here: in the vertical text, cqi would measure the
@@ -884,18 +926,60 @@
884
926
  white-space: nowrap;
885
927
  }
886
928
 
887
- /* short of room, the author gives way first, the publisher last */
929
+ /* short of room, the author gives way first, the publisher, at the foot, last */
888
930
 
889
931
  .spine-author {
890
932
  flex-shrink: 4;
891
933
  }
892
934
 
935
+ /* in the face of the titles, as on the cover (see .drawn-name) */
936
+
893
937
  .spine-name {
894
- @apply font-bold;
938
+ @apply antialiased font-black font-title;
895
939
  }
896
940
 
897
- .spine-publisher {
941
+ .spine-publisher,
942
+ .spine-logo {
898
943
  flex-shrink: 0;
899
944
  margin-inline-start: auto;
900
945
  }
901
946
 
947
+ .spine-publisher {
948
+ color: var(--mds-book-publisher-color, rgb(var(--magma-accent-on-emphasis, var(--tone-neutral-seed, 255 255 255))));
949
+ }
950
+
951
+ /* the mark stands upright, across most of a narrow spine */
952
+
953
+ .spine-logo {
954
+ height: 2lh;
955
+ -webkit-mask-position: center bottom;
956
+ mask-position: center bottom;
957
+ width: 1.4lh;
958
+ }
959
+
960
+ /* Where the spine has room for two lines, three times as wide as its text is high, the author
961
+ goes under the title, smaller, as on a thick volume, and the publisher stays at the foot,
962
+ across both. A narrower spine keeps one line. */
963
+
964
+ @container (width >= 3em) {
965
+ .spine-text {
966
+ display: grid;
967
+ gap: 0 0.8lh;
968
+ grid-template-columns: minmax(0, 1fr) auto;
969
+ }
970
+
971
+ .spine-name {
972
+ grid-area: 1 / 1;
973
+ }
974
+
975
+ .spine-author {
976
+ font-size: 80%;
977
+ grid-area: 2 / 1;
978
+ }
979
+
980
+ .spine-publisher,
981
+ .spine-logo {
982
+ grid-area: 1 / 2 / span 2;
983
+ }
984
+ }
985
+
@@ -16,6 +16,7 @@ import localeIt from "./meta/locale.it.json";
16
16
  export class MdsBook {
17
17
  constructor() {
18
18
  this.imageError = false;
19
+ this.logoError = false;
19
20
  // The pose is animated here, not in CSS: the light on each face and the gloss of the cover
20
21
  // follow the angle frame by frame, which a transition of the transform alone cannot do. It
21
22
  // eases toward its goal, and runs only while it moves, as the 3D card of the docs home does.
@@ -207,6 +208,32 @@ export class MdsBook {
207
208
  this.imageError = true;
208
209
  };
209
210
  this.hasImage = () => { var _a; return ((_a = this.src) !== null && _a !== void 0 ? _a : '') !== '' && !this.imageError; };
211
+ // The mark is fetched as a mask fetches its image, with CORS, so a mark the mask could not
212
+ // paint fails here too and leaves the name of the publisher; a new one forgets the last.
213
+ this.loadLogo = () => {
214
+ var _a;
215
+ if (this.logoLoader) {
216
+ this.logoLoader.onload = null;
217
+ this.logoLoader.onerror = null;
218
+ }
219
+ this.logoLoader = undefined;
220
+ this.logoError = false;
221
+ this.logoUrl = undefined;
222
+ const src = ((_a = this.publisherLogo) !== null && _a !== void 0 ? _a : '').trim();
223
+ if (src === '' || !Build.isBrowser)
224
+ return;
225
+ const image = new Image();
226
+ image.crossOrigin = 'anonymous';
227
+ image.onload = () => {
228
+ this.logoUrl = image.src;
229
+ };
230
+ image.onerror = () => {
231
+ this.logoError = true;
232
+ };
233
+ image.src = src;
234
+ this.logoLoader = image;
235
+ };
236
+ this.logoPending = () => { var _a; return ((_a = this.publisherLogo) !== null && _a !== void 0 ? _a : '').trim() !== '' && this.logoUrl === undefined && !this.logoError; };
210
237
  // a fixed format wins over the image; auto waits for it, and keeps 17x24 without one
211
238
  this.ratio = () => { var _a, _b; return (_b = (_a = bookFormatRatio(this.format)) !== null && _a !== void 0 ? _a : this.imageRatio) !== null && _b !== void 0 ? _b : defaultBookRatio; };
212
239
  this.label = () => {
@@ -241,10 +268,24 @@ export class MdsBook {
241
268
  if (this.coverUrl !== undefined && this.hasImage()) {
242
269
  style['--private-book-cover'] = cssUrl(this.coverUrl);
243
270
  }
271
+ if (this.logoUrl !== undefined) {
272
+ style['--private-book-logo'] = cssUrl(this.logoUrl);
273
+ }
244
274
  return style;
245
275
  };
276
+ // The publisher at the foot of the spine and of a drawn cover: its mark once loaded, its name
277
+ // without one or when the mark fails. While the mark loads the place stays empty, so the name
278
+ // does not show for a moment and then give way to it.
279
+ this.renderPublisher = (place) => {
280
+ var _a;
281
+ if (this.logoUrl !== undefined)
282
+ return h("span", { class: `${place}-logo` });
283
+ if (this.logoPending() || ((_a = this.publisher) !== null && _a !== void 0 ? _a : '') === '')
284
+ return null;
285
+ return h("span", { class: `${place}-publisher` }, this.publisher);
286
+ };
246
287
  // a spine too narrow for its text shows none, as a thin booklet does (see .spine-text)
247
- this.renderSpineText = () => (h("div", { class: "spine-text" }, this.author && h("span", { class: "spine-author" }, this.author), this.name && h("span", { class: "spine-name" }, this.name), this.publisher && h("span", { class: "spine-publisher" }, this.publisher)));
288
+ this.renderSpineText = () => (h("div", { class: "spine-text" }, this.name && h("span", { class: "spine-name" }, this.name), this.author && h("span", { class: "spine-author" }, this.author), this.renderPublisher('spine')));
248
289
  // the light of a face: a dark layer whose opacity follows how much the face turns away
249
290
  this.shade = () => h("span", { class: "shade" });
250
291
  // Rigid boards are slabs with edges of their own, a little larger than the page block they
@@ -287,6 +328,9 @@ export class MdsBook {
287
328
  poseHandler() {
288
329
  this.aim();
289
330
  }
331
+ publisherLogoHandler() {
332
+ this.loadLogo();
333
+ }
290
334
  srcHandler() {
291
335
  this.coverUrl = undefined;
292
336
  this.imageError = false;
@@ -381,6 +425,7 @@ export class MdsBook {
381
425
  this.warnInvalidFormat(this.format);
382
426
  this.warnInvalidPages(this.pages);
383
427
  this.current = this.goal = restPose(this.pose);
428
+ this.loadLogo();
384
429
  }
385
430
  // after every render, so the faces a new binding brings take the light of the pose at once,
386
431
  // and a book told to keep still (a preference that changed) goes back to its pose
@@ -405,12 +450,12 @@ export class MdsBook {
405
450
  const hardcover = this.binding === 'hardcover';
406
451
  if (!hardcover)
407
452
  this.slats = [];
408
- return (h(Host, Object.assign({ key: 'bb31d3ccdd45d59a6586d179bec741c03f424137' }, this.hostRole(), { "pref-animation": preferenceStore.state.animation, "pref-consumption": preferenceStore.state.consumption,
453
+ return (h(Host, Object.assign({ key: '6db72570ca99aeae50cd052ce53087f6838176d5' }, this.hostRole(), { "pref-animation": preferenceStore.state.animation, "pref-consumption": preferenceStore.state.consumption,
409
454
  // the proportions of the book are those of the host, as an image keeps its own
410
- style: { '--private-book-ratio': String(this.ratio()) } }), h("div", { key: 'd9f8342b3fbb727a4e8bf7fcc0bb8ef3ea2882bb', class: "scene", ref: (el) => (this.scene = el) }, h("div", { key: '49ed3560379bf7f7dfbc6a08674c87e80235b86f', class: "stage" }, h("div", { key: 'ab97382a831ca738280c51fed61c518fd536f597', class: {
455
+ style: { '--private-book-ratio': String(this.ratio()) } }), h("div", { key: 'a29488e2e6b9082dfdb9eff07f02f99914226643', class: "scene", ref: (el) => (this.scene = el) }, h("div", { key: 'fa6308238a1093dc99028cf46719f2e2597300fb', class: "stage" }, h("div", { key: 'dfd216ee44d9f22a7fc01a76553871969ce8e24d', class: {
411
456
  book: true,
412
457
  'book--pending': this.hasImage() && this.coverUrl === undefined,
413
- }, style: this.bookStyle() }, h("div", { key: '8c91cb0b329bcf9bf6ab643fd3a0eef0722aba07', class: "floor floor--stand" }), h("div", { key: 'e31e08f16ed68c3a7b43a12974ac46bb94312525', class: "floor floor--lie" }), h("div", { key: 'ddc2cf056c231994f1baa01c6ebf1af6369c1459', class: "body" }, h("div", { key: '6fa239a5ebfd2ec588db478faf6961cde3689950', class: "face front lit-front" }, this.hasImage() ? (h("img", { alt: "", "aria-hidden": "true", class: "cover", draggable: false, loading: this.loading, onError: this.onError, onLoad: this.onLoad, part: "cover", src: this.src })) : (h("div", { "aria-hidden": "true", class: "drawn-cover" }, this.author && h("span", { class: "drawn-author" }, this.author), this.name && h("span", { class: "drawn-name" }, this.name), this.publisher && h("span", { class: "drawn-publisher" }, this.publisher))), h("span", { key: '57fa73e7b9b201a245b2f0ae7ee00bb60e726556', class: "gloss" }), this.shade()), hardcover ? this.renderHardcover() : this.renderPaperback()))))));
458
+ }, style: this.bookStyle() }, h("div", { key: 'b355dc416691ccb540ddfc66ef4878fb2a3b0f94', class: "floor floor--stand" }), h("div", { key: '6a9c1d6da5077a160c28e0ed042dae5331009f1e', class: "floor floor--lie" }), h("div", { key: '34ba5e97961fce9af6dd2f76e9dbc3cb66f1c5b9', class: "body" }, h("div", { key: '17881cac62566ff36b44f5ed76e6d2355df3cb3f', class: "face front lit-front" }, this.hasImage() ? (h("img", { alt: "", "aria-hidden": "true", class: "cover", draggable: false, loading: this.loading, onError: this.onError, onLoad: this.onLoad, part: "cover", src: this.src })) : (h("div", { "aria-hidden": "true", class: "drawn-cover" }, this.author && h("span", { class: "drawn-author" }, this.author), this.name && h("span", { class: "drawn-name" }, this.name), this.renderPublisher('drawn'))), h("span", { key: '0ac0926637c0a49703e658ccd67c2f01aa185c19', class: "gloss" }), this.shade()), hardcover ? this.renderHardcover() : this.renderPaperback()))))));
414
459
  }
415
460
  static get is() { return "mds-book"; }
416
461
  static get encapsulation() { return "shadow"; }
@@ -457,7 +502,7 @@ export class MdsBook {
457
502
  "optional": true,
458
503
  "docs": {
459
504
  "tags": [],
460
- "text": "The author, printed on the spine and on the cover drawn when there is no image"
505
+ "text": "The author, printed on the cover drawn when there is no image, above the title, and on the\nspine after the title, or under it where the spine has room for two lines"
461
506
  },
462
507
  "getter": false,
463
508
  "setter": false,
@@ -626,13 +671,35 @@ export class MdsBook {
626
671
  "optional": true,
627
672
  "docs": {
628
673
  "tags": [],
629
- "text": "The publisher, printed at the foot of the spine and of the cover drawn when there is no image"
674
+ "text": "The publisher, printed at the foot of the spine and of the cover drawn when there is no\nimage, unless its `publisher-logo` is printed there instead"
630
675
  },
631
676
  "getter": false,
632
677
  "setter": false,
633
678
  "reflect": false,
634
679
  "attribute": "publisher"
635
680
  },
681
+ "publisherLogo": {
682
+ "type": "string",
683
+ "mutable": false,
684
+ "complexType": {
685
+ "original": "string",
686
+ "resolved": "string | undefined",
687
+ "references": {}
688
+ },
689
+ "required": false,
690
+ "optional": true,
691
+ "docs": {
692
+ "tags": [{
693
+ "name": "example",
694
+ "text": "'/logos/maggioli-editore.svg'"
695
+ }],
696
+ "text": "The mark of the publisher, printed instead of its name at the foot of the spine and of the\ncover drawn when there is no image: the path to an svg, or a png on a transparent ground.\nIts shape is printed, not its colours, in `--mds-book-publisher-color`. An image from\nanother origin needs CORS headers, as any mask does; one that does not load leaves the name"
697
+ },
698
+ "getter": false,
699
+ "setter": false,
700
+ "reflect": false,
701
+ "attribute": "publisher-logo"
702
+ },
636
703
  "src": {
637
704
  "type": "string",
638
705
  "mutable": false,
@@ -658,7 +725,9 @@ export class MdsBook {
658
725
  return {
659
726
  "coverUrl": {},
660
727
  "imageError": {},
661
- "imageRatio": {}
728
+ "imageRatio": {},
729
+ "logoError": {},
730
+ "logoUrl": {}
662
731
  };
663
732
  }
664
733
  static get elementRef() { return "host"; }
@@ -672,6 +741,9 @@ export class MdsBook {
672
741
  }, {
673
742
  "propName": "pose",
674
743
  "methodName": "poseHandler"
744
+ }, {
745
+ "propName": "publisherLogo",
746
+ "methodName": "publisherLogoHandler"
675
747
  }, {
676
748
  "propName": "src",
677
749
  "methodName": "srcHandler"
@@ -88,6 +88,20 @@ Without `src`, the component draws a cover with the title, the author and the pu
88
88
  ></mds-book>
89
89
  ```
90
90
 
91
+ #### The Mark of the Publisher
92
+
93
+ Give the mark of the publisher instead of printing its name: it goes at the foot of the spine, and of the cover when the component draws it. Its shape is printed in the colour of the text, or in `--mds-book-publisher-color`; keep `publisher`, printed if the mark does not load.
94
+
95
+ ```html
96
+ <mds-book
97
+ name="Agenda dei servizi demografici 2027"
98
+ author="Redazione Maggioli"
99
+ publisher="Maggioli Editore"
100
+ publisher-logo="/logos/maggioli-editore.svg"
101
+ style="--mds-book-color: #f2a93b; --mds-book-text-color: #ffffff"
102
+ ></mds-book>
103
+ ```
104
+
91
105
  #### A Solid Spine
92
106
 
93
107
  When the left edge of the cover does not continue well onto the spine (a photo, a thin white border), give the spine and the board edges a colour of their own.
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-breadcrumb
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-breadcrumb>` web component is the navigation-trail container of the Magma Design System. It is a compound parent that arranges a sequence of slotted `<mds-breadcrumb-item>` children into a hierarchical path and adds an optional back-navigation control.
12
12
 
@@ -30,6 +30,7 @@ Visual styling (item button colors, separator arrow color) is not driven by prop
30
30
 
31
31
  - [`pattern.md`](pattern.md) - correct usage, with examples
32
32
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
33
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-breadcrumb--docs) - the live examples, in the published Storybook of `main`
33
34
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
34
35
 
35
36
  ## Props
@@ -1,10 +1,11 @@
1
1
  {
2
- "timestamp": "2026-10-24T18:39:37",
2
+ "timestamp": "2026-10-27T10:28:31",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
+ "storybook": "https://magma-design-system.github.io/magma/storybook/",
8
9
  "components": [
9
10
  {
10
11
  "filePath": "src/components/mds-breadcrumb/mds-breadcrumb.tsx",
@@ -174,7 +175,8 @@
174
175
  "mds-icon",
175
176
  "mds-text"
176
177
  ]
177
- }
178
+ },
179
+ "storybook": "ui-breadcrumb--docs"
178
180
  }
179
181
  ]
180
182
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-breadcrumb-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-breadcrumb-item>` web component represents a single navigable depth in a breadcrumb trail. It is a compound child of [`<mds-breadcrumb>`](../mds-breadcrumb/AGENTS.md) and renders a clickable label followed by a separator arrow.
12
12
 
@@ -29,6 +29,7 @@ This child exposes essentially no visual configuration of its own - appearance i
29
29
 
30
30
  - [`pattern.md`](pattern.md) - correct usage, with examples
31
31
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
32
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-breadcrumb-breadcrumb-item--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-breadcrumb-item/mds-breadcrumb-item.tsx",
@@ -170,7 +171,8 @@
170
171
  "mds-icon",
171
172
  "mds-text"
172
173
  ]
173
- }
174
+ },
175
+ "storybook": "ui-breadcrumb-breadcrumb-item--docs"
174
176
  }
175
177
  ]
176
178
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-button
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-button>` web component is the primary interactive action control of the Magma Design System. It renders as a button, or as a link when `href` is set, handling form association, accessibility, loading state, and iconography natively.
12
12
 
@@ -40,6 +40,7 @@ The shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../.
40
40
 
41
41
  - [`pattern.md`](pattern.md) - correct usage, with examples
42
42
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
43
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-button--docs) - the live examples, in the published Storybook of `main`
43
44
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
44
45
 
45
46
  ## 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-button/mds-button.tsx",
@@ -949,7 +950,8 @@
949
950
  "mds-url-view": [
950
951
  "mds-button"
951
952
  ]
952
- }
953
+ },
954
+ "storybook": "ui-button--docs"
953
955
  }
954
956
  ]
955
957
  }