@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-hr/mds-hr.tsx",
@@ -32,7 +33,8 @@
32
33
  "states": [],
33
34
  "dependents": [],
34
35
  "dependencies": [],
35
- "dependencyGraph": {}
36
+ "dependencyGraph": {},
37
+ "storybook": "ui-hr--docs"
36
38
  }
37
39
  ]
38
40
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-icon
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-icon>` web component is the single glyph primitive of the Magma Design System: it inlines an SVG into the DOM so the artwork inherits color and sizing from CSS, and it is the building block that nearly every other component (button, chip, input, banner, list-item, etc.) composes to render its iconography. It replaces a raw `<img>`/`<svg>` tag and centralizes how icon artwork is resolved.
12
12
 
@@ -27,6 +27,7 @@ This component does not use the shared `variant` / `tone` / `size` ladders defin
27
27
 
28
28
  - [`pattern.md`](pattern.md) - correct usage, with examples
29
29
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
30
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/design-icon--docs) - the live examples, in the published Storybook of `main`
30
31
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
31
32
 
32
33
  ## Props
@@ -1,10 +1,11 @@
1
1
  {
2
- "timestamp": "2026-10-24T18:39:37",
2
+ "timestamp": "2026-10-27T10:28:31",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
+ "storybook": "https://magma-design-system.github.io/magma/storybook/",
8
9
  "components": [
9
10
  {
10
11
  "filePath": "src/components/mds-icon/mds-icon.tsx",
@@ -207,7 +208,8 @@
207
208
  "mds-usage": [
208
209
  "mds-icon"
209
210
  ]
210
- }
211
+ },
212
+ "storybook": "design-icon--docs"
211
213
  }
212
214
  ]
213
215
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-img
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-img>` web component is the responsive image primitive of the Magma Design System. It wraps the native `<img>` element, adding accessible defaults, a built-in error/fallback state, and data-consumption-aware source selection driven by the user's bandwidth preference.
12
12
 
@@ -31,6 +31,7 @@ Most props are pass-throughs to the native image attributes of the same name (`s
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-image--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-img/mds-img.tsx",
@@ -476,7 +477,8 @@
476
477
  "mds-push-notification-item": [
477
478
  "mds-img"
478
479
  ]
479
- }
480
+ },
481
+ "storybook": "ui-image--docs"
480
482
  }
481
483
  ]
482
484
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input
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-input>` web component is the primary single- and multi-line text entry control of the Magma Design System. It wraps a native `<input>` (or `<textarea>` when `type="textarea"`) and layers on form association, validation, inline tips, iconography, password masking, numeric steppers, datalist suggestions and speech-to-text dictation.
12
12
 
@@ -45,6 +45,7 @@ The shared `variant` ladder (color role) is defined in [`agents/variants.md`](..
45
45
 
46
46
  - [`pattern.md`](pattern.md) - correct usage, with examples
47
47
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
48
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/form-input--docs) - the live examples, in the published Storybook of `main`
48
49
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
49
50
 
50
51
  ## 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-input/mds-input.tsx",
@@ -1697,7 +1698,8 @@
1697
1698
  "mds-input-otp": [
1698
1699
  "mds-input"
1699
1700
  ]
1700
- }
1701
+ },
1702
+ "storybook": "form-input--docs"
1701
1703
  }
1702
1704
  ]
1703
1705
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-date
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-input-date>` web component is the Magma Design System control for capturing a single calendar date. It wraps a native `<input type="date">`, adding form association, ISO value validation against an optional `min`/`max` range, contextual tips, and a button-triggered calendar dropdown for visual date picking.
12
12
 
@@ -39,6 +39,7 @@ The shared `variant` ladder is defined in [`agents/variants.md`](../../../../age
39
39
 
40
40
  - [`pattern.md`](pattern.md) - correct usage, with examples
41
41
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
42
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/form-input-date--docs) - the live examples, in the published Storybook of `main`
42
43
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
43
44
 
44
45
  ## 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-input-date/mds-input-date.tsx",
@@ -713,7 +714,8 @@
713
714
  "mds-calendar-cell": [
714
715
  "mds-button"
715
716
  ]
716
- }
717
+ },
718
+ "storybook": "form-input-date--docs"
717
719
  }
718
720
  ]
719
721
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-date-range
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-input-date-range>` web component is the Magma Design System control for capturing a start/end date pair, composing two slotted `<mds-input-date>` fields with a shared pop-up `mds-calendar` (in range mode) and optional quick-pick presets. It is a form-associated compound parent that orchestrates its children rather than rendering its own native inputs.
12
12
 
@@ -36,6 +36,7 @@ The `<mds-input-date-range>` web component is the Magma Design System control fo
36
36
 
37
37
  - [`pattern.md`](pattern.md) - correct usage, with examples
38
38
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
39
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/form-input-date-range--docs) - the live examples, in the published Storybook of `main`
39
40
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
40
41
 
41
42
  ## 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-input-date-range/mds-input-date-range.tsx",
@@ -572,7 +573,8 @@
572
573
  "mds-calendar-cell": [
573
574
  "mds-button"
574
575
  ]
575
- }
576
+ },
577
+ "storybook": "form-input-date-range--docs"
576
578
  }
577
579
  ]
578
580
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-date-range-preselection
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-input-date-range-preselection>` web component is a compound child of [`<mds-input-date-range>`](../mds-input-date-range/AGENTS.md). It renders a clickable shortcut button (a quick range like "Last 7 days" or "This month") that, when activated, fills the parent's date range with a predefined `start`/`end` pair instead of requiring the user to pick dates manually on the calendar.
12
12
 
@@ -27,6 +27,7 @@ The default slot holds the human-readable label. Visual states (default, hover,
27
27
 
28
28
  - [`pattern.md`](pattern.md) - correct usage, with examples
29
29
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
30
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/form-input-date-range-preselection--docs) - the live examples, in the published Storybook of `main`
30
31
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
31
32
 
32
33
  ## Props
@@ -1,10 +1,11 @@
1
1
  {
2
- "timestamp": "2026-10-24T18:39:37",
2
+ "timestamp": "2026-10-27T10:28:31",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
+ "storybook": "https://magma-design-system.github.io/magma/storybook/",
8
9
  "components": [
9
10
  {
10
11
  "filePath": "src/components/mds-input-date-range-preselection/mds-input-date-range-preselection.tsx",
@@ -201,7 +202,8 @@
201
202
  "mds-icon",
202
203
  "mds-text"
203
204
  ]
204
- }
205
+ },
206
+ "storybook": "form-input-date-range-preselection--docs"
205
207
  }
206
208
  ]
207
209
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-field
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-input-field>` web component is the form-field wrapper of the Magma Design System. It does not render an input itself; instead it decorates a slotted `<mds-input>` (or similar control) with a top label and a bottom message area, and reacts to the control's validation lifecycle. It plays the role the native `<label>` + helper-text grouping plays around an `<input>`.
12
12
 
@@ -26,6 +26,7 @@ The `<mds-input-field>` web component is the form-field wrapper of the Magma Des
26
26
 
27
27
  - [`pattern.md`](pattern.md) - correct usage, with examples
28
28
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
29
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/form-input-field--docs) - the live examples, in the published Storybook of `main`
29
30
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
30
31
 
31
32
  ## 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-input-field/mds-input-field.tsx",
@@ -182,7 +183,8 @@
182
183
  "mds-input-field": [
183
184
  "mds-text"
184
185
  ]
185
- }
186
+ },
187
+ "storybook": "form-input-field--docs"
186
188
  }
187
189
  ]
188
190
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-otp
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-input-otp>` web component is the Magma Design System control for entering one-time passcodes, rendering a row of single-digit fields that together compose a single form value. It is form-associated, so it behaves like a native input whose value is the concatenated OTP code.
12
12
 
@@ -32,6 +32,7 @@ The `<mds-input-otp>` web component is the Magma Design System control for enter
32
32
 
33
33
  - [`pattern.md`](pattern.md) - correct usage, with examples
34
34
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
35
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/form-otp--docs) - the live examples, in the published Storybook of `main`
35
36
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
36
37
 
37
38
  ## Props
@@ -1,10 +1,11 @@
1
1
  {
2
- "timestamp": "2026-10-24T18:39:37",
2
+ "timestamp": "2026-10-27T10:28:31",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
+ "storybook": "https://magma-design-system.github.io/magma/storybook/",
8
9
  "components": [
9
10
  {
10
11
  "filePath": "src/components/mds-input-otp/mds-input-otp.tsx",
@@ -19,7 +20,7 @@
19
20
  ],
20
21
  "usage": {
21
22
  "1. Description": "The `<mds-input-otp>` web component is the Magma Design System control for entering one-time passcodes, rendering a row of single-digit fields that together compose a single form value. It is form-associated, so it behaves like a native input whose value is the concatenated OTP code.\n\n#### Semantic Behavior\n\n- **Form association**: The joined digits are exposed as the form value, so it submits with the surrounding `<form>` with no extra wiring. A form reset brings back the code of load, in the cells and in the form, like a native input.\n- **Disabled fieldset**: A disabled `<fieldset>` around the component disables it as `disabled` does, like a native control: the code cannot be changed and is left out of the form, until the fieldset is enabled.\n- **Single-digit cells**: Renders `length` digit cells, each capped at one character; the host value is the concatenation of every cell.\n- **Numeric-only entry**: A key that writes anything but a digit (a letter, Space) changes nothing; a digit typed on a filled cell overwrites it.\n- **Keyboard**: Backspace empties the cell, or the previous one from an empty cell, and moves there; Delete empties the cell; the left and right arrows move between the cells. Tab and Shift+Tab leave the field, and the shortcuts (paste with Ctrl+V or Cmd+V among them) keep what the browser does with them.\n- **Auto-advance focus**: After a valid digit, focus moves to the next cell automatically; entering a digit in the last cell blurs it.\n- **Paste handling**: Pasting a code of digits (the spaces around it are dropped) distributes the digits across consecutive cells starting from the focused one; a paste with anything else in it, signs and decimal points included, is ignored.\n- **Completion + submit**: When a digit typed or pasted in the last cell completes all `length` digits and `autosubmit` is set, the owning form is submitted; digits pasted past the last cell are dropped.\n\n#### Properties & Visual Configurations\n\n- **`length`** sets how many digit cells are rendered and therefore the expected code length; it doubles as the completeness threshold for auto-submit. Defaults to `6`.\n- **`disabled`** disables every cell, like a disabled native input: the code cannot be changed and is left out of the form. The cells take the disabled look without the disabled tip, which a single-digit cell has no room for.\n- **`autosubmit`** opts into automatic form submission the moment the code is complete - use it for flows where the OTP is the only field and no explicit confirm button is needed; leave it off when the user should review or trigger submission manually.\n- **`value`** holds the current concatenated code; read it to observe progress. A value written in the markup or set by code fills the cells from the first one, as many digits as there are cells, and reaches the form.\n",
22
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-input-otp>` 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#### Default Six-Digit Code\n\nThe component renders six single-digit cells by default. Drop it into a form with a `name` attribute so the concatenated value is submitted as a named field.\n\n```html\n<form action=\"/verify\" method=\"post\">\n <mds-input-otp name=\"otp\"></mds-input-otp>\n <mds-button type=\"submit\" label=\"Verifica\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Custom Code Length\n\nSet `length` to match the expected OTP length - 4 digits for a short PIN, 8 for a longer token.\n\n```html\n<!-- Four-digit PIN -->\n<mds-input-otp name=\"pin\" length=\"4\"></mds-input-otp>\n\n<!-- Eight-digit token -->\n<mds-input-otp name=\"token\" length=\"8\"></mds-input-otp>\n```\n\n#### Auto-Submit on Completion\n\nAdd the `autosubmit` boolean attribute when the OTP is the only field and no explicit confirm button is needed. The owning form is submitted when a digit typed or pasted in the last cell completes the code - do not set `autosubmit=\"false\"` to disable it; remove the attribute instead.\n\n```html\n<form action=\"/verify\" method=\"post\">\n <mds-input-otp name=\"otp\" autosubmit></mds-input-otp>\n</form>\n```\n\n#### Reading the Value Programmatically\n\n`value` is a reflected attribute that updates as the user types. Read it directly from the element or listen for form data. Set it to fill the cells from code, for example to prefill a code the page already knows; a form reset brings back the value of load.\n\n```javascript\nconst otp = document.querySelector('mds-input-otp');\n\n// Poll current state\nconsole.log(otp.value); // e.g. \"124\" while in progress: empty cells add nothing\n\n// React on form submit\ndocument.querySelector('form').addEventListener('submit', (e) => {\n e.preventDefault();\n const data = new FormData(e.target);\n console.log('Codice OTP:', data.get('otp'));\n});\n```\n\n#### Full Authentication Flow\n\nCombine `autosubmit` with a submit handler to verify the code and reflect the result - pair with [`mds-button`](../mds-button/AGENTS.md) in await state while the request is in flight.\n\n```html\n<form id=\"otp-form\" action=\"/auth/otp\" method=\"post\">\n <mds-input-otp name=\"otp\" length=\"6\" autosubmit></mds-input-otp>\n\n <mds-button\n id=\"submit-btn\"\n type=\"submit\"\n label=\"Conferma codice\"\n variant=\"primary\"\n tone=\"strong\"\n disabled\n ></mds-button>\n</form>\n\n<script>\n const form = document.getElementById('otp-form');\n const btn = document.getElementById('submit-btn');\n const otpEl = form.querySelector('mds-input-otp');\n\n // Enable the button only once all digits are entered\n setInterval(() => {\n btn.disabled = otpEl.value.length < 6 ? true : undefined;\n }, 100);\n\n form.addEventListener('submit', async (e) => {\n e.preventDefault();\n btn.setAttribute('await', '');\n // ... send request, then remove await\n });\n</script>\n```\n\n#### Layout Alignment\n\nThe host is an `inline-flex` container. Use a utility class to center it inside a card or modal.\n\n```html\n<div class=\"flex justify-center py-600\">\n <mds-input-otp name=\"otp\"></mds-input-otp>\n</div>\n```\n",
23
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-input-otp>` 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#### Default Six-Digit Code\n\nThe component renders six single-digit cells by default. Drop it into a form with a `name` attribute so the concatenated value is submitted as a named field; the server behind the form's `action` checks the code.\n\n```html\n<form action=\"/verify\" method=\"post\">\n <mds-input-otp name=\"otp\"></mds-input-otp>\n <mds-button type=\"submit\" label=\"Verifica\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Custom Code Length\n\nSet `length` to match the expected OTP length - 4 digits for a short PIN, 8 for a longer token.\n\n```html\n<!-- Four-digit PIN -->\n<mds-input-otp name=\"pin\" length=\"4\"></mds-input-otp>\n\n<!-- Eight-digit token -->\n<mds-input-otp name=\"token\" length=\"8\"></mds-input-otp>\n```\n\n#### Auto-Submit on Completion\n\nAdd the `autosubmit` boolean attribute when the OTP is the only field and no explicit confirm button is needed. The owning form is submitted when a digit typed or pasted in the last cell completes the code - do not set `autosubmit=\"false\"` to disable it; remove the attribute instead.\n\n```html\n<form action=\"/verify\" method=\"post\">\n <mds-input-otp name=\"otp\" autosubmit></mds-input-otp>\n</form>\n```\n\n#### Reading the Value Programmatically\n\n`value` is a reflected attribute that updates as the user types. Read it directly from the element or listen for form data. Set it to fill the cells from code, for example to prefill a code the page already knows; a form reset brings back the value of load.\n\n```javascript\nconst otp = document.querySelector('mds-input-otp');\n\n// Poll current state\nconsole.log(otp.value); // e.g. \"124\" while in progress: empty cells add nothing\n\n// React on form submit\ndocument.querySelector('form').addEventListener('submit', (e) => {\n e.preventDefault();\n const data = new FormData(e.target);\n console.log('Codice OTP:', data.get('otp'));\n});\n```\n\n#### Full Authentication Flow\n\nCombine `autosubmit` with a submit handler to verify the code and reflect the result - pair with [`mds-button`](../mds-button/AGENTS.md) in await state while the request is in flight.\n\n```html\n<form id=\"otp-form\" action=\"/auth/otp\" method=\"post\">\n <mds-input-otp name=\"otp\" length=\"6\" autosubmit></mds-input-otp>\n\n <mds-button\n id=\"submit-btn\"\n type=\"submit\"\n label=\"Conferma codice\"\n variant=\"primary\"\n tone=\"strong\"\n disabled\n ></mds-button>\n</form>\n\n<script>\n const form = document.getElementById('otp-form');\n const btn = document.getElementById('submit-btn');\n const otpEl = form.querySelector('mds-input-otp');\n\n // Enable the button only once all digits are entered\n setInterval(() => {\n btn.disabled = otpEl.value.length < 6 ? true : undefined;\n }, 100);\n\n form.addEventListener('submit', async (e) => {\n e.preventDefault();\n btn.setAttribute('await', '');\n // ... send request, then remove await\n });\n</script>\n```\n\n#### Layout Alignment\n\nThe host is an `inline-flex` container. Use a utility class to center it inside a card or modal.\n\n```html\n<div class=\"flex justify-center py-600\">\n <mds-input-otp name=\"otp\"></mds-input-otp>\n</div>\n```\n",
23
24
  "3. Antipattern": "Common incorrect uses of `<mds-input-otp>`. 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 Set `autosubmit=\"false\"` to Disable Auto-Submit\n\n`autosubmit` is a boolean attribute and `mds-input-otp` is form-associated: as on a native control, any value turns it on, `\"false\"` included, so this markup submits the form as soon as the code is complete. Remove the attribute entirely to opt out.\n\n```html\n<!-- INCORRECT -->\n<mds-input-otp name=\"otp\" autosubmit=\"false\"></mds-input-otp>\n\n<!-- CORRECT -->\n<mds-input-otp name=\"otp\"></mds-input-otp>\n```\n\n#### Do Not Build a Row of Native `<input>` Elements Instead\n\nHand-rolling digit cells with native `<input type=\"text\" maxlength=\"1\">` elements duplicates focus management, paste handling, and form association that `<mds-input-otp>` already provides, and breaks Magma theming.\n\n```html\n<!-- INCORRECT -->\n<div class=\"otp-row\">\n <input type=\"text\" maxlength=\"1\">\n <input type=\"text\" maxlength=\"1\">\n <input type=\"text\" maxlength=\"1\">\n <input type=\"text\" maxlength=\"1\">\n <input type=\"text\" maxlength=\"1\">\n <input type=\"text\" maxlength=\"1\">\n</div>\n\n<!-- CORRECT -->\n<mds-input-otp name=\"otp\"></mds-input-otp>\n```\n\n#### Do Not Pierce Shadow DOM to Style Inner Cells\n\nThe inner `mds-input` cells are Shadow DOM internals. Targeting them with descendant selectors or `>>>` will break silently on any internal refactor.\n\n```css\n/* INCORRECT */\nmds-input-otp mds-input {\n --mds-input-background: red;\n}\nmds-input-otp >>> .input {\n border-radius: 0;\n}\n\n/* CORRECT - style the host layout only */\nmds-input-otp {\n gap: calc(var(--spacing) * 600);\n}\n```\n\n#### Do Not Use `autosubmit` Without a Parent `<form>`\n\n`autosubmit` calls `internals.form.requestSubmit()`. Outside a `<form>` there is no owning form, so the call is silently ignored and the expected submission never fires.\n\n```html\n<!-- INCORRECT - no owning form, submit never fires -->\n<mds-input-otp name=\"otp\" autosubmit></mds-input-otp>\n\n<!-- CORRECT - wrapped in a form that handles the submit -->\n<form action=\"/verify\" method=\"post\">\n <mds-input-otp name=\"otp\" autosubmit></mds-input-otp>\n</form>\n```\n\n#### Do Not Listen for the Native `input` or `change` Event\n\nNative DOM events may not propagate out of shadow DOM the way you expect. Read the reflected `value` attribute or use form data on submit instead.\n\n```javascript\n// INCORRECT\ndocument.querySelector('mds-input-otp').addEventListener('input', (e) => {\n console.log(e.target.value); // unreliable from outside shadow DOM\n});\n\n// CORRECT - read the reflected prop directly\nconst otpEl = document.querySelector('mds-input-otp');\ndocument.querySelector('form').addEventListener('submit', (e) => {\n e.preventDefault();\n console.log('Codice OTP:', otpEl.value);\n});\n```\n\n#### Do Not Set `length` as a Non-Integer or to Zero\n\n`length` controls how many cells are rendered. A fractional or zero value produces no cells or the wrong number. Always pass a positive integer.\n\n```html\n<!-- INCORRECT -->\n<mds-input-otp name=\"otp\" length=\"0\"></mds-input-otp>\n<mds-input-otp name=\"otp\" length=\"4.5\"></mds-input-otp>\n\n<!-- CORRECT -->\n<mds-input-otp name=\"otp\" length=\"4\"></mds-input-otp>\n```\n"
24
25
  },
25
26
  "props": [
@@ -202,7 +203,8 @@
202
203
  "mds-input-tip-item": [
203
204
  "mds-text"
204
205
  ]
205
- }
206
+ },
207
+ "storybook": "form-otp--docs"
206
208
  }
207
209
  ]
208
210
  }
@@ -11,7 +11,7 @@ Correct and idiomatic ways to use the `<mds-input-otp>` component, ordered from
11
11
 
12
12
  #### Default Six-Digit Code
13
13
 
14
- The component renders six single-digit cells by default. Drop it into a form with a `name` attribute so the concatenated value is submitted as a named field.
14
+ The component renders six single-digit cells by default. Drop it into a form with a `name` attribute so the concatenated value is submitted as a named field; the server behind the form's `action` checks the code.
15
15
 
16
16
  ```html
17
17
  <form action="/verify" method="post">
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-range
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-input-range>` web component is the Magma Design System slider control for picking a single numeric value from a continuous interval. It wraps a native `<input type="range">`, adding a labelled header, a styled track with a live progress fill, form association, and value formatting.
12
12
 
@@ -32,6 +32,7 @@ This component does not use the shared `variant` / `tone` ladders ([`agents/vari
32
32
 
33
33
  - [`pattern.md`](pattern.md) - correct usage, with examples
34
34
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
35
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/form-range--docs) - the live examples, in the published Storybook of `main`
35
36
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
36
37
 
37
38
  ## Props
@@ -1,10 +1,11 @@
1
1
  {
2
- "timestamp": "2026-10-24T18:39:37",
2
+ "timestamp": "2026-10-27T10:28:31",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
+ "storybook": "https://magma-design-system.github.io/magma/storybook/",
8
9
  "components": [
9
10
  {
10
11
  "filePath": "src/components/mds-input-range/mds-input-range.tsx",
@@ -322,7 +323,8 @@
322
323
  "mds-input-range": [
323
324
  "mds-text"
324
325
  ]
325
- }
326
+ },
327
+ "storybook": "form-range--docs"
326
328
  }
327
329
  ]
328
330
  }
@@ -219,19 +219,21 @@ mds-text {
219
219
  * for dark. `dark` is the explicit choice; `system` and no controller follow the
220
220
  * OS via @media; the scheme axis gates it. Cross-browser, no :host-context.
221
221
  *
222
- * The thumb is light in dark, as the off knob of mds-input-switch: text-default, 5.19:1 on the
223
- * empty track. It used to take accent-emphasis, the colour of its own ring and of the progress,
224
- * so the three were one shape and the thumb could not be seen. */
222
+ * In dark the progress is accent-emphasis, a light blue, and the thumb sits on it inside a ring of
223
+ * the same colour: it takes the ink of that fill, text-on-emphasis, as the knob of an
224
+ * mds-input-switch that is on (#1141). 10.19:1 on the progress, 3.16:1 on the empty track.
225
+ * It used to take accent-emphasis, the colour of its ring and of the progress, so the three
226
+ * were one shape (#1073); then text-default, light like the progress, 1.61:1 on it. */
225
227
 
226
228
  :host([pref-mode='dark']:not([pref-theme-scheme='light'])) {
227
- --mds-input-range-thumb-background: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
229
+ --mds-input-range-thumb-background: rgb(var(--magma-text-on-emphasis, var(--tone-neutral-seed, 255 255 255)));
228
230
  --mds-input-range-track-progress-background: rgb(var(--magma-accent-emphasis, var(--variant-primary-04, 36 103 231)));
229
231
  }
230
232
 
231
233
  @media (prefers-color-scheme: dark) {
232
234
  :host([pref-mode='system']:not([pref-theme-scheme='light'])),
233
235
  :host(:not([pref-mode])) {
234
- --mds-input-range-thumb-background: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
236
+ --mds-input-range-thumb-background: rgb(var(--magma-text-on-emphasis, var(--tone-neutral-seed, 255 255 255)));
235
237
  --mds-input-range-track-progress-background: rgb(var(--magma-accent-emphasis, var(--variant-primary-04, 36 103 231)));
236
238
  }
237
239
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-select
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-input-select>` web component is the Magma Design System single- and multi-choice dropdown control. It wraps a native `<select>` element, adding form association, accessible status feedback, and themed chrome while accepting plain `<option>` elements through its default slot.
12
12
 
@@ -38,6 +38,7 @@ The `variant` prop applies a status appearance drawn from the shared status ladd
38
38
 
39
39
  - [`pattern.md`](pattern.md) - correct usage, with examples
40
40
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
41
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/form-select--docs) - the live examples, in the published Storybook of `main`
41
42
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
42
43
 
43
44
  ## 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-input-select/mds-input-select.tsx",
@@ -610,7 +611,8 @@
610
611
  "mds-input-tip-item": [
611
612
  "mds-text"
612
613
  ]
613
- }
614
+ },
615
+ "storybook": "form-select--docs"
614
616
  }
615
617
  ]
616
618
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-switch
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-input-switch>` web component is the binary/selectable input control of the Magma Design System. A single tag covers three native primitives - it renders as a toggle switch by default and re-renders as a native `checkbox` or `radio` depending on `type`, wrapping `<input type="checkbox|radio">` with form association, accessibility, and iconography handled natively.
12
12
 
@@ -37,6 +37,7 @@ The `<mds-input-switch>` web component is the binary/selectable input control of
37
37
 
38
38
  - [`pattern.md`](pattern.md) - correct usage, with examples
39
39
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
40
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/form-switch--docs) - the live examples, in the published Storybook of `main`
40
41
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
41
42
 
42
43
  ## 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-input-switch/mds-input-switch.tsx",
@@ -663,7 +664,8 @@
663
664
  "mds-table-row": [
664
665
  "mds-input-switch"
665
666
  ]
666
- }
667
+ },
668
+ "storybook": "form-switch--docs"
667
669
  }
668
670
  ]
669
671
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-tip
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-input-tip>` web component is the floating helper container of the Magma Design System input family: it overlays an input field and carries supplementary content (slotted `mds-input-tip-item` chips: status labels, hints, counters) that slides into place when the field becomes active. It is a presentational compound child positioned against its parent input rather than a standalone control.
12
12
 
@@ -26,6 +26,7 @@ The `<mds-input-tip>` web component is the floating helper container of the Magm
26
26
 
27
27
  - [`pattern.md`](pattern.md) - correct usage, with examples
28
28
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
29
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/form-input-tip--docs) - the live examples, in the published Storybook of `main`
29
30
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
30
31
 
31
32
  ## 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-input-tip/mds-input-tip.tsx",
@@ -163,7 +164,8 @@
163
164
  "mds-input-select": [
164
165
  "mds-input-tip"
165
166
  ]
166
- }
167
+ },
168
+ "storybook": "form-input-tip--docs"
167
169
  }
168
170
  ]
169
171
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-tip-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-input-tip-item>` web component is a single contextual hint row rendered inside the [`<mds-input-tip>`](../mds-input-tip/AGENTS.md) container. It represents one validation/status message of a form field (required, read-only, disabled, character count, or free text) and is orchestrated by the input components (`<mds-input>`, `<mds-input-date>`, `<mds-input-select>`) that own the tip; it has no standalone HTML equivalent.
12
12
 
@@ -29,6 +29,7 @@ Its public styling hooks (`--mds-input-tip-item-background`, `--mds-input-tip-it
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/form-input-tip-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