@maggioli-design-system/magma 2.5.0 → 2.6.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 (1515) hide show
  1. package/AGENTS.md +19 -4
  2. package/CHANGELOG.md +61 -0
  3. package/LICENSE +21 -0
  4. package/agents/assets.md +1 -1
  5. package/agents/color.md +22 -4
  6. package/agents/components.md +164 -92
  7. package/agents/conventions.md +24 -7
  8. package/agents/install.md +7 -0
  9. package/agents/lint.md +270 -0
  10. package/agents/mcp.md +103 -0
  11. package/agents/theming.md +8 -0
  12. package/dist/cjs/index-BQNHYWJg.js +4 -0
  13. package/dist/cjs/{index-CWTZb9W2.js → index-Bg68W-da.js} +1 -1
  14. package/dist/cjs/loader.cjs.js +1 -1
  15. package/dist/cjs/{locale-Os4wg65H.js → locale-CaR39iYg.js} +12 -6
  16. package/dist/cjs/magma-components.cjs.js +1 -1
  17. package/dist/cjs/mds-accordion-item.cjs.entry.js +1 -1
  18. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +1 -1
  19. package/dist/cjs/mds-accordion-timer.cjs.entry.js +1 -1
  20. package/dist/cjs/mds-accordion.cjs.entry.js +1 -1
  21. package/dist/cjs/mds-author.cjs.entry.js +1 -1
  22. package/dist/cjs/mds-avatar-stack-item.cjs.entry.js +1 -1
  23. package/dist/cjs/mds-avatar-stack.cjs.entry.js +1 -1
  24. package/dist/cjs/mds-avatar.cjs.entry.js +1 -1
  25. package/dist/cjs/mds-badge.cjs.entry.js +1 -1
  26. package/dist/cjs/mds-banner_3.cjs.entry.js +4 -4
  27. package/dist/cjs/mds-benchmark-bar.cjs.entry.js +1 -1
  28. package/dist/cjs/mds-bibliography.cjs.entry.js +1 -1
  29. package/dist/cjs/mds-book.cjs.entry.js +703 -0
  30. package/dist/cjs/mds-breadcrumb-item.cjs.entry.js +1 -1
  31. package/dist/cjs/mds-breadcrumb.cjs.entry.js +2 -2
  32. package/dist/cjs/mds-button-dropdown.cjs.entry.js +2 -2
  33. package/dist/cjs/mds-button-group.cjs.entry.js +1 -1
  34. package/dist/cjs/mds-button_3.cjs.entry.js +6 -6
  35. package/dist/cjs/mds-calendar_2.cjs.entry.js +7 -7
  36. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  37. package/dist/cjs/mds-card-footer.cjs.entry.js +1 -1
  38. package/dist/cjs/mds-card-header.cjs.entry.js +1 -1
  39. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  40. package/dist/cjs/mds-card.cjs.entry.js +1 -1
  41. package/dist/cjs/mds-details.cjs.entry.js +1 -1
  42. package/dist/cjs/mds-dropdown.cjs.entry.js +2 -2
  43. package/dist/cjs/mds-emoji.cjs.entry.js +2 -2
  44. package/dist/cjs/mds-entity.cjs.entry.js +1 -1
  45. package/dist/cjs/mds-file-preview.cjs.entry.js +3 -3
  46. package/dist/cjs/mds-file.cjs.entry.js +2 -2
  47. package/dist/cjs/mds-filter-item.cjs.entry.js +2 -2
  48. package/dist/cjs/mds-filter.cjs.entry.js +2 -2
  49. package/dist/cjs/mds-header-bar.cjs.entry.js +2 -2
  50. package/dist/cjs/mds-header.cjs.entry.js +2 -2
  51. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +2 -2
  52. package/dist/cjs/mds-hr.cjs.entry.js +1 -1
  53. package/dist/cjs/mds-img.cjs.entry.js +1 -1
  54. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +1 -1
  55. package/dist/cjs/mds-input-date-range.cjs.entry.js +3 -3
  56. package/dist/cjs/mds-input-date.cjs.entry.js +4 -4
  57. package/dist/cjs/mds-input-field.cjs.entry.js +1 -1
  58. package/dist/cjs/mds-input-otp.cjs.entry.js +2 -2
  59. package/dist/cjs/mds-input-range.cjs.entry.js +2 -2
  60. package/dist/cjs/mds-input-select.cjs.entry.js +9 -5
  61. package/dist/cjs/mds-input-switch_2.cjs.entry.js +3 -3
  62. package/dist/cjs/mds-input-tip_2.cjs.entry.js +4 -4
  63. package/dist/cjs/mds-input-upload.cjs.entry.js +6 -6
  64. package/dist/cjs/mds-input.cjs.entry.js +154 -37
  65. package/dist/cjs/mds-keyboard-key.cjs.entry.js +3 -3
  66. package/dist/cjs/mds-keyboard.cjs.entry.js +8 -4
  67. package/dist/cjs/mds-kpi-item.cjs.entry.js +1 -1
  68. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  69. package/dist/cjs/mds-label.cjs.entry.js +2 -2
  70. package/dist/cjs/mds-link.cjs.entry.js +4 -4
  71. package/dist/cjs/mds-list-item.cjs.entry.js +1 -1
  72. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  73. package/dist/cjs/mds-mention.cjs.entry.js +2 -2
  74. package/dist/cjs/mds-modal.cjs.entry.js +4 -4
  75. package/dist/cjs/mds-note.cjs.entry.js +2 -2
  76. package/dist/cjs/mds-notification.cjs.entry.js +1 -1
  77. package/dist/cjs/mds-paginator-item.cjs.entry.js +1 -1
  78. package/dist/cjs/mds-paginator.cjs.entry.js +2 -2
  79. package/dist/cjs/mds-policy-ai.cjs.entry.js +2 -2
  80. package/dist/cjs/mds-pref-animation.cjs.entry.js +2 -2
  81. package/dist/cjs/mds-pref-consumption.cjs.entry.js +2 -2
  82. package/dist/cjs/mds-pref-contrast.cjs.entry.js +2 -2
  83. package/dist/cjs/mds-pref-language-item.cjs.entry.js +2 -2
  84. package/dist/cjs/mds-pref-language.cjs.entry.js +2 -2
  85. package/dist/cjs/mds-pref-mode.cjs.entry.js +2 -2
  86. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +1 -1
  87. package/dist/cjs/mds-pref-theme.cjs.entry.js +2 -2
  88. package/dist/cjs/mds-pref.cjs.entry.js +2 -2
  89. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +1 -1
  90. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +1 -1
  91. package/dist/cjs/mds-price-table-features.cjs.entry.js +1 -1
  92. package/dist/cjs/mds-price-table-header.cjs.entry.js +1 -1
  93. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +1 -1
  94. package/dist/cjs/mds-price-table-list.cjs.entry.js +1 -1
  95. package/dist/cjs/mds-price-table.cjs.entry.js +1 -1
  96. package/dist/cjs/mds-progress_2.cjs.entry.js +2 -2
  97. package/dist/cjs/mds-push-notification-item.cjs.entry.js +3 -3
  98. package/dist/cjs/mds-push-notification.cjs.entry.js +3 -3
  99. package/dist/cjs/mds-quote.cjs.entry.js +1 -1
  100. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +1 -1
  101. package/dist/cjs/mds-radial-menu.cjs.entry.js +2 -2
  102. package/dist/cjs/mds-separator.cjs.entry.js +1 -1
  103. package/dist/cjs/mds-status-bar.cjs.entry.js +2 -2
  104. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +7 -5
  105. package/dist/cjs/mds-stepper-bar.cjs.entry.js +1 -1
  106. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +1 -1
  107. package/dist/cjs/mds-tab-bar.cjs.entry.js +1 -1
  108. package/dist/cjs/mds-tab_2.cjs.entry.js +4 -4
  109. package/dist/cjs/mds-table-body.cjs.entry.js +1 -1
  110. package/dist/cjs/mds-table-footer.cjs.entry.js +1 -1
  111. package/dist/cjs/mds-table-header-cell.cjs.entry.js +1 -1
  112. package/dist/cjs/mds-table-header.cjs.entry.js +2 -2
  113. package/dist/cjs/mds-table-row.cjs.entry.js +3 -3
  114. package/dist/cjs/mds-table.cjs.entry.js +2 -2
  115. package/dist/cjs/mds-text.cjs.entry.js +1 -1
  116. package/dist/cjs/mds-toast-region.cjs.entry.js +1 -1
  117. package/dist/cjs/mds-toast.cjs.entry.js +2 -2
  118. package/dist/cjs/mds-tooltip.cjs.entry.js +2 -2
  119. package/dist/cjs/mds-tree-item.cjs.entry.js +2 -2
  120. package/dist/cjs/mds-tree.cjs.entry.js +1 -1
  121. package/dist/cjs/mds-url-view.cjs.entry.js +2 -2
  122. package/dist/cjs/mds-usage.cjs.entry.js +2 -2
  123. package/dist/cjs/mds-video-wall.cjs.entry.js +1 -1
  124. package/dist/cjs/mds-zero.cjs.entry.js +1 -1
  125. package/dist/collection/collection-manifest.json +1 -0
  126. package/dist/collection/common/locale.js +12 -6
  127. package/dist/collection/components/mds-accordion/AGENTS.md +3 -5
  128. package/dist/collection/components/mds-accordion/antipattern.md +1 -2
  129. package/dist/collection/components/mds-accordion/documentation.json +21 -10
  130. package/dist/collection/components/mds-accordion/mds-accordion.css +3 -3
  131. package/dist/collection/components/mds-accordion/mds-accordion.js +2 -1
  132. package/dist/collection/components/mds-accordion/pattern.md +1 -4
  133. package/dist/collection/components/mds-accordion-item/AGENTS.md +3 -7
  134. package/dist/collection/components/mds-accordion-item/documentation.json +20 -9
  135. package/dist/collection/components/mds-accordion-item/mds-accordion-item.css +1 -1
  136. package/dist/collection/components/mds-accordion-item/mds-accordion-item.js +2 -1
  137. package/dist/collection/components/mds-accordion-item/pattern.md +3 -5
  138. package/dist/collection/components/mds-accordion-timer/AGENTS.md +3 -5
  139. package/dist/collection/components/mds-accordion-timer/antipattern.md +5 -3
  140. package/dist/collection/components/mds-accordion-timer/documentation.json +17 -8
  141. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.css +1 -1
  142. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.js +2 -1
  143. package/dist/collection/components/mds-accordion-timer/pattern.md +6 -6
  144. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +3 -5
  145. package/dist/collection/components/mds-accordion-timer-item/antipattern.md +1 -2
  146. package/dist/collection/components/mds-accordion-timer-item/documentation.json +17 -8
  147. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.css +1 -1
  148. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.js +2 -1
  149. package/dist/collection/components/mds-accordion-timer-item/pattern.md +1 -5
  150. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  151. package/dist/collection/components/mds-author/documentation.json +5 -1
  152. package/dist/collection/components/mds-author/mds-author.js +2 -1
  153. package/dist/collection/components/mds-avatar/AGENTS.md +3 -3
  154. package/dist/collection/components/mds-avatar/antipattern.md +1 -1
  155. package/dist/collection/components/mds-avatar/documentation.json +17 -8
  156. package/dist/collection/components/mds-avatar/mds-avatar.css +3 -3
  157. package/dist/collection/components/mds-avatar/mds-avatar.js +2 -1
  158. package/dist/collection/components/mds-avatar/pattern.md +1 -2
  159. package/dist/collection/components/mds-avatar-stack/AGENTS.md +3 -12
  160. package/dist/collection/components/mds-avatar-stack/antipattern.md +1 -2
  161. package/dist/collection/components/mds-avatar-stack/documentation.json +31 -15
  162. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.css +1 -1
  163. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.js +2 -1
  164. package/dist/collection/components/mds-avatar-stack/pattern.md +2 -5
  165. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +3 -6
  166. package/dist/collection/components/mds-avatar-stack-item/documentation.json +22 -10
  167. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.css +2 -2
  168. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.js +4 -1
  169. package/dist/collection/components/mds-avatar-stack-item/pattern.md +4 -5
  170. package/dist/collection/components/mds-badge/AGENTS.md +3 -3
  171. package/dist/collection/components/mds-badge/antipattern.md +1 -1
  172. package/dist/collection/components/mds-badge/documentation.json +17 -8
  173. package/dist/collection/components/mds-badge/mds-badge.css +3 -3
  174. package/dist/collection/components/mds-badge/mds-badge.js +2 -1
  175. package/dist/collection/components/mds-badge/pattern.md +4 -7
  176. package/dist/collection/components/mds-banner/AGENTS.md +3 -8
  177. package/dist/collection/components/mds-banner/antipattern.md +1 -2
  178. package/dist/collection/components/mds-banner/documentation.json +29 -14
  179. package/dist/collection/components/mds-banner/mds-banner.css +4 -4
  180. package/dist/collection/components/mds-banner/mds-banner.js +2 -1
  181. package/dist/collection/components/mds-banner/pattern.md +1 -2
  182. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +1 -1
  183. package/dist/collection/components/mds-benchmark-bar/documentation.json +5 -1
  184. package/dist/collection/components/mds-benchmark-bar/mds-benchmark-bar.js +2 -1
  185. package/dist/collection/components/mds-bibliography/AGENTS.md +3 -3
  186. package/dist/collection/components/mds-bibliography/antipattern.md +1 -3
  187. package/dist/collection/components/mds-bibliography/documentation.json +15 -7
  188. package/dist/collection/components/mds-bibliography/mds-bibliography.css +1 -1
  189. package/dist/collection/components/mds-bibliography/mds-bibliography.js +4 -1
  190. package/dist/collection/components/mds-bibliography/pattern.md +1 -3
  191. package/dist/collection/components/mds-book/AGENTS.md +79 -0
  192. package/dist/collection/components/mds-book/antipattern.md +88 -0
  193. package/dist/collection/components/mds-book/documentation.json +482 -0
  194. package/dist/collection/components/mds-book/mds-book.css +901 -0
  195. package/dist/collection/components/mds-book/mds-book.js +731 -0
  196. package/dist/collection/components/mds-book/meta/dictionary.js +5 -0
  197. package/dist/collection/components/mds-book/meta/format.js +57 -0
  198. package/dist/collection/components/mds-book/meta/pose.js +107 -0
  199. package/dist/collection/components/mds-book/meta/spine.js +61 -0
  200. package/dist/collection/components/mds-book/meta/types.js +1 -0
  201. package/dist/collection/components/mds-book/meta/volume.js +23 -0
  202. package/dist/collection/components/mds-book/pattern.md +111 -0
  203. package/dist/collection/components/mds-breadcrumb/AGENTS.md +3 -14
  204. package/dist/collection/components/mds-breadcrumb/antipattern.md +1 -1
  205. package/dist/collection/components/mds-breadcrumb/documentation.json +28 -14
  206. package/dist/collection/components/mds-breadcrumb/mds-breadcrumb.js +2 -1
  207. package/dist/collection/components/mds-breadcrumb/pattern.md +6 -6
  208. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +3 -11
  209. package/dist/collection/components/mds-breadcrumb-item/antipattern.md +3 -3
  210. package/dist/collection/components/mds-breadcrumb-item/documentation.json +22 -11
  211. package/dist/collection/components/mds-breadcrumb-item/mds-breadcrumb-item.js +2 -1
  212. package/dist/collection/components/mds-breadcrumb-item/pattern.md +12 -14
  213. package/dist/collection/components/mds-button/AGENTS.md +3 -12
  214. package/dist/collection/components/mds-button/documentation.json +37 -17
  215. package/dist/collection/components/mds-button/mds-button.css +5 -5
  216. package/dist/collection/components/mds-button/mds-button.js +5 -4
  217. package/dist/collection/components/mds-button-dropdown/AGENTS.md +1 -1
  218. package/dist/collection/components/mds-button-dropdown/documentation.json +7 -2
  219. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.css +1 -1
  220. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +2 -1
  221. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  222. package/dist/collection/components/mds-button-group/documentation.json +5 -1
  223. package/dist/collection/components/mds-button-group/mds-button-group.js +2 -1
  224. package/dist/collection/components/mds-calendar/AGENTS.md +3 -6
  225. package/dist/collection/components/mds-calendar/antipattern.md +1 -1
  226. package/dist/collection/components/mds-calendar/documentation.json +25 -12
  227. package/dist/collection/components/mds-calendar/mds-calendar.css +4 -4
  228. package/dist/collection/components/mds-calendar/mds-calendar.js +6 -5
  229. package/dist/collection/components/mds-calendar/pattern.md +1 -3
  230. package/dist/collection/components/mds-calendar-cell/AGENTS.md +3 -35
  231. package/dist/collection/components/mds-calendar-cell/antipattern.md +1 -2
  232. package/dist/collection/components/mds-calendar-cell/documentation.json +81 -40
  233. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.css +2 -2
  234. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.js +4 -1
  235. package/dist/collection/components/mds-calendar-cell/pattern.md +4 -5
  236. package/dist/collection/components/mds-card/AGENTS.md +1 -1
  237. package/dist/collection/components/mds-card/antipattern.md +2 -2
  238. package/dist/collection/components/mds-card/documentation.json +13 -6
  239. package/dist/collection/components/mds-card/mds-card.css +3 -3
  240. package/dist/collection/components/mds-card/mds-card.js +2 -1
  241. package/dist/collection/components/mds-card/pattern.md +4 -4
  242. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  243. package/dist/collection/components/mds-card-content/documentation.json +5 -1
  244. package/dist/collection/components/mds-card-content/mds-card-content.js +2 -1
  245. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  246. package/dist/collection/components/mds-card-footer/documentation.json +5 -1
  247. package/dist/collection/components/mds-card-footer/mds-card-footer.js +2 -1
  248. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  249. package/dist/collection/components/mds-card-header/documentation.json +5 -1
  250. package/dist/collection/components/mds-card-header/mds-card-header.js +2 -1
  251. package/dist/collection/components/mds-card-media/AGENTS.md +1 -1
  252. package/dist/collection/components/mds-card-media/documentation.json +5 -1
  253. package/dist/collection/components/mds-card-media/mds-card-media.js +2 -1
  254. package/dist/collection/components/mds-chip/AGENTS.md +3 -10
  255. package/dist/collection/components/mds-chip/antipattern.md +2 -3
  256. package/dist/collection/components/mds-chip/documentation.json +35 -17
  257. package/dist/collection/components/mds-chip/mds-chip.css +4 -4
  258. package/dist/collection/components/mds-chip/mds-chip.js +4 -1
  259. package/dist/collection/components/mds-chip/pattern.md +4 -6
  260. package/dist/collection/components/mds-details/AGENTS.md +3 -7
  261. package/dist/collection/components/mds-details/antipattern.md +1 -5
  262. package/dist/collection/components/mds-details/documentation.json +14 -7
  263. package/dist/collection/components/mds-details/mds-details.js +2 -1
  264. package/dist/collection/components/mds-details/pattern.md +4 -6
  265. package/dist/collection/components/mds-dropdown/AGENTS.md +3 -9
  266. package/dist/collection/components/mds-dropdown/antipattern.md +1 -1
  267. package/dist/collection/components/mds-dropdown/documentation.json +31 -15
  268. package/dist/collection/components/mds-dropdown/mds-dropdown.css +4 -4
  269. package/dist/collection/components/mds-dropdown/mds-dropdown.js +3 -2
  270. package/dist/collection/components/mds-dropdown/pattern.md +2 -4
  271. package/dist/collection/components/mds-emoji/AGENTS.md +8 -32
  272. package/dist/collection/components/mds-emoji/antipattern.md +0 -18
  273. package/dist/collection/components/mds-emoji/documentation.json +73 -35
  274. package/dist/collection/components/mds-emoji/mds-emoji.css +8 -5
  275. package/dist/collection/components/mds-emoji/mds-emoji.js +4 -1
  276. package/dist/collection/components/mds-emoji/pattern.md +9 -25
  277. package/dist/collection/components/mds-entity/AGENTS.md +3 -4
  278. package/dist/collection/components/mds-entity/antipattern.md +10 -3
  279. package/dist/collection/components/mds-entity/documentation.json +17 -8
  280. package/dist/collection/components/mds-entity/mds-entity.css +2 -2
  281. package/dist/collection/components/mds-entity/mds-entity.js +2 -1
  282. package/dist/collection/components/mds-entity/pattern.md +1 -4
  283. package/dist/collection/components/mds-file/AGENTS.md +3 -3
  284. package/dist/collection/components/mds-file/antipattern.md +2 -3
  285. package/dist/collection/components/mds-file/documentation.json +15 -7
  286. package/dist/collection/components/mds-file/mds-file.css +1 -1
  287. package/dist/collection/components/mds-file/mds-file.js +4 -1
  288. package/dist/collection/components/mds-file/pattern.md +1 -3
  289. package/dist/collection/components/mds-file-preview/AGENTS.md +3 -3
  290. package/dist/collection/components/mds-file-preview/antipattern.md +1 -1
  291. package/dist/collection/components/mds-file-preview/documentation.json +17 -8
  292. package/dist/collection/components/mds-file-preview/mds-file-preview.css +3 -3
  293. package/dist/collection/components/mds-file-preview/mds-file-preview.js +3 -2
  294. package/dist/collection/components/mds-file-preview/pattern.md +2 -3
  295. package/dist/collection/components/mds-filter/AGENTS.md +3 -8
  296. package/dist/collection/components/mds-filter/antipattern.md +2 -2
  297. package/dist/collection/components/mds-filter/documentation.json +27 -13
  298. package/dist/collection/components/mds-filter/mds-filter.css +3 -3
  299. package/dist/collection/components/mds-filter/mds-filter.js +2 -1
  300. package/dist/collection/components/mds-filter/pattern.md +2 -5
  301. package/dist/collection/components/mds-filter-item/AGENTS.md +2 -7
  302. package/dist/collection/components/mds-filter-item/antipattern.md +4 -4
  303. package/dist/collection/components/mds-filter-item/documentation.json +17 -8
  304. package/dist/collection/components/mds-filter-item/mds-filter-item.js +4 -1
  305. package/dist/collection/components/mds-filter-item/pattern.md +5 -7
  306. package/dist/collection/components/mds-header/AGENTS.md +4 -8
  307. package/dist/collection/components/mds-header/documentation.json +28 -13
  308. package/dist/collection/components/mds-header/mds-header.css +7 -7
  309. package/dist/collection/components/mds-header/mds-header.js +2 -1
  310. package/dist/collection/components/mds-header/pattern.md +1 -3
  311. package/dist/collection/components/mds-header-bar/AGENTS.md +2 -4
  312. package/dist/collection/components/mds-header-bar/antipattern.md +6 -8
  313. package/dist/collection/components/mds-header-bar/documentation.json +9 -4
  314. package/dist/collection/components/mds-header-bar/mds-header-bar.js +2 -1
  315. package/dist/collection/components/mds-header-bar/pattern.md +10 -6
  316. package/dist/collection/components/mds-help/AGENTS.md +1 -1
  317. package/dist/collection/components/mds-help/documentation.json +13 -5
  318. package/dist/collection/components/mds-help/mds-help.css +4 -4
  319. package/dist/collection/components/mds-help/mds-help.js +2 -1
  320. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +5 -11
  321. package/dist/collection/components/mds-horizontal-scroll/antipattern.md +2 -2
  322. package/dist/collection/components/mds-horizontal-scroll/documentation.json +34 -14
  323. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.css +2 -1
  324. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.js +2 -1
  325. package/dist/collection/components/mds-horizontal-scroll/pattern.md +4 -15
  326. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  327. package/dist/collection/components/mds-hr/documentation.json +7 -2
  328. package/dist/collection/components/mds-hr/mds-hr.js +4 -1
  329. package/dist/collection/components/mds-icon/AGENTS.md +1 -1
  330. package/dist/collection/components/mds-icon/documentation.json +5 -1
  331. package/dist/collection/components/mds-icon/mds-icon.js +2 -1
  332. package/dist/collection/components/mds-img/AGENTS.md +3 -5
  333. package/dist/collection/components/mds-img/antipattern.md +1 -1
  334. package/dist/collection/components/mds-img/documentation.json +19 -9
  335. package/dist/collection/components/mds-img/mds-img.css +2 -2
  336. package/dist/collection/components/mds-img/mds-img.js +1 -0
  337. package/dist/collection/components/mds-img/pattern.md +1 -4
  338. package/dist/collection/components/mds-input/AGENTS.md +6 -10
  339. package/dist/collection/components/mds-input/antipattern.md +1 -1
  340. package/dist/collection/components/mds-input/documentation.json +40 -20
  341. package/dist/collection/components/mds-input/mds-input.css +8 -8
  342. package/dist/collection/components/mds-input/mds-input.js +13 -7
  343. package/dist/collection/components/mds-input/meta/input-type/InputValidationManager.js +3 -3
  344. package/dist/collection/components/mds-input/meta/validators.js +28 -13
  345. package/dist/collection/components/mds-input/meta/validity.js +8 -10
  346. package/dist/collection/components/mds-input/pattern.md +1 -3
  347. package/dist/collection/components/mds-input-date/AGENTS.md +3 -8
  348. package/dist/collection/components/mds-input-date/antipattern.md +1 -1
  349. package/dist/collection/components/mds-input-date/documentation.json +31 -15
  350. package/dist/collection/components/mds-input-date/mds-input-date.css +5 -5
  351. package/dist/collection/components/mds-input-date/mds-input-date.js +3 -2
  352. package/dist/collection/components/mds-input-date/pattern.md +1 -2
  353. package/dist/collection/components/mds-input-date-range/AGENTS.md +3 -4
  354. package/dist/collection/components/mds-input-date-range/documentation.json +22 -10
  355. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +5 -5
  356. package/dist/collection/components/mds-input-date-range/mds-input-date-range.js +3 -2
  357. package/dist/collection/components/mds-input-date-range/pattern.md +1 -2
  358. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +3 -13
  359. package/dist/collection/components/mds-input-date-range-preselection/antipattern.md +11 -6
  360. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +26 -13
  361. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.js +2 -1
  362. package/dist/collection/components/mds-input-date-range-preselection/pattern.md +1 -11
  363. package/dist/collection/components/mds-input-field/AGENTS.md +1 -1
  364. package/dist/collection/components/mds-input-field/documentation.json +9 -3
  365. package/dist/collection/components/mds-input-field/mds-input-field.css +2 -2
  366. package/dist/collection/components/mds-input-field/mds-input-field.js +2 -1
  367. package/dist/collection/components/mds-input-otp/AGENTS.md +1 -1
  368. package/dist/collection/components/mds-input-otp/documentation.json +7 -2
  369. package/dist/collection/components/mds-input-otp/mds-input-otp.js +4 -1
  370. package/dist/collection/components/mds-input-range/AGENTS.md +3 -13
  371. package/dist/collection/components/mds-input-range/antipattern.md +1 -5
  372. package/dist/collection/components/mds-input-range/documentation.json +26 -13
  373. package/dist/collection/components/mds-input-range/mds-input-range.css +26 -19
  374. package/dist/collection/components/mds-input-range/mds-input-range.js +2 -1
  375. package/dist/collection/components/mds-input-range/pattern.md +2 -12
  376. package/dist/collection/components/mds-input-select/AGENTS.md +4 -8
  377. package/dist/collection/components/mds-input-select/antipattern.md +1 -1
  378. package/dist/collection/components/mds-input-select/documentation.json +26 -13
  379. package/dist/collection/components/mds-input-select/mds-input-select.css +3 -3
  380. package/dist/collection/components/mds-input-select/mds-input-select.js +8 -3
  381. package/dist/collection/components/mds-input-select/pattern.md +1 -3
  382. package/dist/collection/components/mds-input-switch/AGENTS.md +2 -30
  383. package/dist/collection/components/mds-input-switch/antipattern.md +5 -6
  384. package/dist/collection/components/mds-input-switch/documentation.json +61 -30
  385. package/dist/collection/components/mds-input-switch/mds-input-switch.js +2 -1
  386. package/dist/collection/components/mds-input-switch/pattern.md +2 -11
  387. package/dist/collection/components/mds-input-tip/AGENTS.md +3 -5
  388. package/dist/collection/components/mds-input-tip/antipattern.md +10 -6
  389. package/dist/collection/components/mds-input-tip/documentation.json +17 -8
  390. package/dist/collection/components/mds-input-tip/mds-input-tip.css +1 -1
  391. package/dist/collection/components/mds-input-tip/mds-input-tip.js +2 -1
  392. package/dist/collection/components/mds-input-tip/pattern.md +1 -4
  393. package/dist/collection/components/mds-input-tip-item/AGENTS.md +4 -3
  394. package/dist/collection/components/mds-input-tip-item/antipattern.md +2 -2
  395. package/dist/collection/components/mds-input-tip-item/documentation.json +14 -7
  396. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.css +2 -2
  397. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.js +3 -2
  398. package/dist/collection/components/mds-input-tip-item/pattern.md +1 -2
  399. package/dist/collection/components/mds-input-upload/AGENTS.md +3 -5
  400. package/dist/collection/components/mds-input-upload/antipattern.md +2 -3
  401. package/dist/collection/components/mds-input-upload/documentation.json +19 -9
  402. package/dist/collection/components/mds-input-upload/mds-input-upload.css +1 -1
  403. package/dist/collection/components/mds-input-upload/mds-input-upload.js +8 -5
  404. package/dist/collection/components/mds-input-upload/pattern.md +1 -5
  405. package/dist/collection/components/mds-keyboard/AGENTS.md +4 -19
  406. package/dist/collection/components/mds-keyboard/antipattern.md +3 -3
  407. package/dist/collection/components/mds-keyboard/documentation.json +48 -24
  408. package/dist/collection/components/mds-keyboard/mds-keyboard.css +17 -5
  409. package/dist/collection/components/mds-keyboard/mds-keyboard.js +7 -2
  410. package/dist/collection/components/mds-keyboard/pattern.md +1 -2
  411. package/dist/collection/components/mds-keyboard-key/AGENTS.md +3 -6
  412. package/dist/collection/components/mds-keyboard-key/antipattern.md +1 -2
  413. package/dist/collection/components/mds-keyboard-key/documentation.json +21 -10
  414. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.css +7 -3
  415. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +4 -1
  416. package/dist/collection/components/mds-keyboard-key/pattern.md +1 -12
  417. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  418. package/dist/collection/components/mds-kpi/documentation.json +10 -4
  419. package/dist/collection/components/mds-kpi/mds-kpi.css +2 -2
  420. package/dist/collection/components/mds-kpi/mds-kpi.js +2 -1
  421. package/dist/collection/components/mds-kpi/pattern.md +7 -4
  422. package/dist/collection/components/mds-kpi-item/AGENTS.md +3 -8
  423. package/dist/collection/components/mds-kpi-item/antipattern.md +2 -4
  424. package/dist/collection/components/mds-kpi-item/documentation.json +16 -8
  425. package/dist/collection/components/mds-kpi-item/mds-kpi-item.js +2 -1
  426. package/dist/collection/components/mds-kpi-item/pattern.md +9 -7
  427. package/dist/collection/components/mds-label/AGENTS.md +3 -7
  428. package/dist/collection/components/mds-label/documentation.json +24 -11
  429. package/dist/collection/components/mds-label/mds-label.css +2 -2
  430. package/dist/collection/components/mds-label/mds-label.js +4 -1
  431. package/dist/collection/components/mds-label/pattern.md +1 -3
  432. package/dist/collection/components/mds-link/AGENTS.md +4 -9
  433. package/dist/collection/components/mds-link/documentation.json +22 -10
  434. package/dist/collection/components/mds-link/mds-link.css +1 -1
  435. package/dist/collection/components/mds-link/mds-link.js +4 -3
  436. package/dist/collection/components/mds-list/AGENTS.md +1 -1
  437. package/dist/collection/components/mds-list/documentation.json +6 -2
  438. package/dist/collection/components/mds-list/mds-list.js +2 -1
  439. package/dist/collection/components/mds-list/pattern.md +5 -5
  440. package/dist/collection/components/mds-list-item/AGENTS.md +2 -4
  441. package/dist/collection/components/mds-list-item/antipattern.md +1 -1
  442. package/dist/collection/components/mds-list-item/documentation.json +9 -4
  443. package/dist/collection/components/mds-list-item/mds-list-item.js +2 -1
  444. package/dist/collection/components/mds-list-item/pattern.md +4 -4
  445. package/dist/collection/components/mds-mention/AGENTS.md +2 -4
  446. package/dist/collection/components/mds-mention/antipattern.md +5 -5
  447. package/dist/collection/components/mds-mention/documentation.json +11 -5
  448. package/dist/collection/components/mds-mention/mds-mention.js +4 -1
  449. package/dist/collection/components/mds-mention/pattern.md +3 -5
  450. package/dist/collection/components/mds-modal/AGENTS.md +3 -9
  451. package/dist/collection/components/mds-modal/antipattern.md +1 -3
  452. package/dist/collection/components/mds-modal/documentation.json +37 -18
  453. package/dist/collection/components/mds-modal/mds-modal.css +7 -7
  454. package/dist/collection/components/mds-modal/mds-modal.js +4 -3
  455. package/dist/collection/components/mds-modal/pattern.md +2 -6
  456. package/dist/collection/components/mds-note/AGENTS.md +3 -5
  457. package/dist/collection/components/mds-note/documentation.json +18 -8
  458. package/dist/collection/components/mds-note/mds-note.css +2 -2
  459. package/dist/collection/components/mds-note/mds-note.js +2 -1
  460. package/dist/collection/components/mds-note/pattern.md +1 -3
  461. package/dist/collection/components/mds-notification/AGENTS.md +3 -11
  462. package/dist/collection/components/mds-notification/antipattern.md +2 -2
  463. package/dist/collection/components/mds-notification/documentation.json +33 -16
  464. package/dist/collection/components/mds-notification/mds-notification.css +2 -2
  465. package/dist/collection/components/mds-notification/mds-notification.js +4 -1
  466. package/dist/collection/components/mds-notification/pattern.md +3 -5
  467. package/dist/collection/components/mds-paginator/AGENTS.md +1 -1
  468. package/dist/collection/components/mds-paginator/documentation.json +12 -5
  469. package/dist/collection/components/mds-paginator/mds-paginator.css +2 -2
  470. package/dist/collection/components/mds-paginator/mds-paginator.js +4 -1
  471. package/dist/collection/components/mds-paginator/pattern.md +1 -3
  472. package/dist/collection/components/mds-paginator-item/AGENTS.md +3 -10
  473. package/dist/collection/components/mds-paginator-item/documentation.json +34 -16
  474. package/dist/collection/components/mds-paginator-item/mds-paginator-item.css +5 -5
  475. package/dist/collection/components/mds-paginator-item/mds-paginator-item.js +2 -1
  476. package/dist/collection/components/mds-paginator-item/pattern.md +5 -6
  477. package/dist/collection/components/mds-policy-ai/AGENTS.md +1 -1
  478. package/dist/collection/components/mds-policy-ai/documentation.json +6 -2
  479. package/dist/collection/components/mds-policy-ai/mds-policy-ai.js +2 -1
  480. package/dist/collection/components/mds-policy-ai/pattern.md +4 -4
  481. package/dist/collection/components/mds-pref/AGENTS.md +1 -1
  482. package/dist/collection/components/mds-pref/documentation.json +5 -5
  483. package/dist/collection/components/mds-pref/mds-pref.js +2 -2
  484. package/dist/collection/components/mds-pref-animation/AGENTS.md +1 -1
  485. package/dist/collection/components/mds-pref-animation/documentation.json +7 -2
  486. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +4 -1
  487. package/dist/collection/components/mds-pref-consumption/AGENTS.md +1 -1
  488. package/dist/collection/components/mds-pref-consumption/documentation.json +7 -2
  489. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +4 -1
  490. package/dist/collection/components/mds-pref-contrast/AGENTS.md +1 -1
  491. package/dist/collection/components/mds-pref-contrast/documentation.json +7 -2
  492. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +4 -1
  493. package/dist/collection/components/mds-pref-language/AGENTS.md +1 -1
  494. package/dist/collection/components/mds-pref-language/documentation.json +5 -1
  495. package/dist/collection/components/mds-pref-language/mds-pref-language.js +2 -1
  496. package/dist/collection/components/mds-pref-language-item/AGENTS.md +1 -1
  497. package/dist/collection/components/mds-pref-language-item/documentation.json +7 -2
  498. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +4 -1
  499. package/dist/collection/components/mds-pref-mode/AGENTS.md +3 -3
  500. package/dist/collection/components/mds-pref-mode/antipattern.md +1 -2
  501. package/dist/collection/components/mds-pref-mode/documentation.json +15 -7
  502. package/dist/collection/components/mds-pref-mode/mds-pref-mode.css +1 -1
  503. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +4 -1
  504. package/dist/collection/components/mds-pref-mode/pattern.md +1 -3
  505. package/dist/collection/components/mds-pref-theme/AGENTS.md +1 -1
  506. package/dist/collection/components/mds-pref-theme/documentation.json +6 -2
  507. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +2 -1
  508. package/dist/collection/components/mds-pref-theme/pattern.md +1 -2
  509. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +3 -5
  510. package/dist/collection/components/mds-pref-theme-item/antipattern.md +1 -2
  511. package/dist/collection/components/mds-pref-theme-item/documentation.json +19 -9
  512. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.css +1 -1
  513. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +4 -1
  514. package/dist/collection/components/mds-pref-theme-item/pattern.md +2 -6
  515. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  516. package/dist/collection/components/mds-price-table/documentation.json +6 -2
  517. package/dist/collection/components/mds-price-table/mds-price-table.js +2 -1
  518. package/dist/collection/components/mds-price-table/pattern.md +4 -4
  519. package/dist/collection/components/mds-price-table-features/AGENTS.md +4 -3
  520. package/dist/collection/components/mds-price-table-features/antipattern.md +0 -1
  521. package/dist/collection/components/mds-price-table-features/documentation.json +12 -6
  522. package/dist/collection/components/mds-price-table-features/mds-price-table-features.css +1 -1
  523. package/dist/collection/components/mds-price-table-features/mds-price-table-features.js +2 -1
  524. package/dist/collection/components/mds-price-table-features/pattern.md +2 -3
  525. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +3 -6
  526. package/dist/collection/components/mds-price-table-features-cell/antipattern.md +3 -3
  527. package/dist/collection/components/mds-price-table-features-cell/documentation.json +19 -9
  528. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.css +1 -1
  529. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.js +2 -1
  530. package/dist/collection/components/mds-price-table-features-cell/pattern.md +1 -6
  531. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +3 -3
  532. package/dist/collection/components/mds-price-table-features-row/documentation.json +14 -6
  533. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.css +2 -2
  534. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.js +2 -1
  535. package/dist/collection/components/mds-price-table-features-row/pattern.md +1 -3
  536. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  537. package/dist/collection/components/mds-price-table-header/documentation.json +5 -1
  538. package/dist/collection/components/mds-price-table-header/mds-price-table-header.js +2 -1
  539. package/dist/collection/components/mds-price-table-list/AGENTS.md +3 -5
  540. package/dist/collection/components/mds-price-table-list/antipattern.md +1 -4
  541. package/dist/collection/components/mds-price-table-list/documentation.json +10 -5
  542. package/dist/collection/components/mds-price-table-list/mds-price-table-list.js +2 -1
  543. package/dist/collection/components/mds-price-table-list/pattern.md +12 -7
  544. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +2 -6
  545. package/dist/collection/components/mds-price-table-list-item/antipattern.md +1 -5
  546. package/dist/collection/components/mds-price-table-list-item/documentation.json +13 -6
  547. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.js +2 -1
  548. package/dist/collection/components/mds-price-table-list-item/pattern.md +7 -4
  549. package/dist/collection/components/mds-progress/AGENTS.md +1 -1
  550. package/dist/collection/components/mds-progress/documentation.json +15 -6
  551. package/dist/collection/components/mds-progress/mds-progress.css +5 -5
  552. package/dist/collection/components/mds-progress/mds-progress.js +2 -1
  553. package/dist/collection/components/mds-push-notification/AGENTS.md +4 -7
  554. package/dist/collection/components/mds-push-notification/antipattern.md +2 -2
  555. package/dist/collection/components/mds-push-notification/documentation.json +24 -12
  556. package/dist/collection/components/mds-push-notification/mds-push-notification.css +11 -11
  557. package/dist/collection/components/mds-push-notification/mds-push-notification.js +2 -1
  558. package/dist/collection/components/mds-push-notification/pattern.md +2 -5
  559. package/dist/collection/components/mds-push-notification-item/AGENTS.md +3 -5
  560. package/dist/collection/components/mds-push-notification-item/documentation.json +20 -9
  561. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.css +3 -3
  562. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +3 -2
  563. package/dist/collection/components/mds-push-notification-item/pattern.md +1 -3
  564. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  565. package/dist/collection/components/mds-quote/documentation.json +5 -1
  566. package/dist/collection/components/mds-quote/mds-quote.js +2 -1
  567. package/dist/collection/components/mds-radial-menu/AGENTS.md +4 -11
  568. package/dist/collection/components/mds-radial-menu/documentation.json +31 -15
  569. package/dist/collection/components/mds-radial-menu/mds-radial-menu.css +3 -3
  570. package/dist/collection/components/mds-radial-menu/mds-radial-menu.js +2 -1
  571. package/dist/collection/components/mds-radial-menu/pattern.md +2 -6
  572. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +2 -5
  573. package/dist/collection/components/mds-radial-menu-item/antipattern.md +7 -5
  574. package/dist/collection/components/mds-radial-menu-item/documentation.json +13 -6
  575. package/dist/collection/components/mds-radial-menu-item/mds-radial-menu-item.js +4 -1
  576. package/dist/collection/components/mds-radial-menu-item/pattern.md +6 -8
  577. package/dist/collection/components/mds-radial-progress/AGENTS.md +3 -3
  578. package/dist/collection/components/mds-radial-progress/documentation.json +15 -6
  579. package/dist/collection/components/mds-radial-progress/mds-radial-progress.css +3 -3
  580. package/dist/collection/components/mds-radial-progress/mds-radial-progress.js +2 -1
  581. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  582. package/dist/collection/components/mds-separator/documentation.json +9 -3
  583. package/dist/collection/components/mds-separator/mds-separator.css +1 -1
  584. package/dist/collection/components/mds-separator/mds-separator.js +4 -1
  585. package/dist/collection/components/mds-spinner/AGENTS.md +1 -1
  586. package/dist/collection/components/mds-spinner/documentation.json +9 -3
  587. package/dist/collection/components/mds-spinner/mds-spinner.css +1 -1
  588. package/dist/collection/components/mds-spinner/mds-spinner.js +4 -1
  589. package/dist/collection/components/mds-status-bar/AGENTS.md +3 -3
  590. package/dist/collection/components/mds-status-bar/antipattern.md +0 -1
  591. package/dist/collection/components/mds-status-bar/documentation.json +13 -6
  592. package/dist/collection/components/mds-status-bar/mds-status-bar.css +2 -1
  593. package/dist/collection/components/mds-status-bar/mds-status-bar.js +2 -1
  594. package/dist/collection/components/mds-status-bar/pattern.md +1 -3
  595. package/dist/collection/components/mds-stepper-bar/AGENTS.md +3 -7
  596. package/dist/collection/components/mds-stepper-bar/documentation.json +22 -10
  597. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.css +2 -2
  598. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +2 -1
  599. package/dist/collection/components/mds-stepper-bar/pattern.md +2 -6
  600. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +3 -11
  601. package/dist/collection/components/mds-stepper-bar-item/antipattern.md +3 -3
  602. package/dist/collection/components/mds-stepper-bar-item/documentation.json +31 -15
  603. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.css +2 -2
  604. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.js +7 -4
  605. package/dist/collection/components/mds-stepper-bar-item/pattern.md +2 -5
  606. package/dist/collection/components/mds-tab/AGENTS.md +3 -27
  607. package/dist/collection/components/mds-tab/antipattern.md +1 -3
  608. package/dist/collection/components/mds-tab/documentation.json +67 -33
  609. package/dist/collection/components/mds-tab/mds-tab.css +5 -5
  610. package/dist/collection/components/mds-tab/mds-tab.js +3 -2
  611. package/dist/collection/components/mds-tab/pattern.md +3 -13
  612. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  613. package/dist/collection/components/mds-tab-bar/antipattern.md +2 -2
  614. package/dist/collection/components/mds-tab-bar/documentation.json +7 -3
  615. package/dist/collection/components/mds-tab-bar/mds-tab-bar.js +2 -1
  616. package/dist/collection/components/mds-tab-bar/pattern.md +3 -3
  617. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +4 -4
  618. package/dist/collection/components/mds-tab-bar-item/documentation.json +15 -7
  619. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.css +2 -2
  620. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +2 -1
  621. package/dist/collection/components/mds-tab-bar-item/pattern.md +1 -3
  622. package/dist/collection/components/mds-tab-item/AGENTS.md +2 -8
  623. package/dist/collection/components/mds-tab-item/antipattern.md +3 -3
  624. package/dist/collection/components/mds-tab-item/documentation.json +17 -8
  625. package/dist/collection/components/mds-tab-item/mds-tab-item.js +2 -1
  626. package/dist/collection/components/mds-tab-item/pattern.md +6 -5
  627. package/dist/collection/components/mds-table/AGENTS.md +3 -7
  628. package/dist/collection/components/mds-table/documentation.json +24 -11
  629. package/dist/collection/components/mds-table/mds-table.css +3 -3
  630. package/dist/collection/components/mds-table/mds-table.js +2 -1
  631. package/dist/collection/components/mds-table/pattern.md +2 -6
  632. package/dist/collection/components/mds-table-body/AGENTS.md +3 -4
  633. package/dist/collection/components/mds-table-body/antipattern.md +1 -2
  634. package/dist/collection/components/mds-table-body/documentation.json +17 -8
  635. package/dist/collection/components/mds-table-body/mds-table-body.css +2 -2
  636. package/dist/collection/components/mds-table-body/mds-table-body.js +2 -1
  637. package/dist/collection/components/mds-table-body/pattern.md +1 -4
  638. package/dist/collection/components/mds-table-cell/AGENTS.md +4 -4
  639. package/dist/collection/components/mds-table-cell/antipattern.md +1 -1
  640. package/dist/collection/components/mds-table-cell/documentation.json +16 -8
  641. package/dist/collection/components/mds-table-cell/mds-table-cell.css +2 -2
  642. package/dist/collection/components/mds-table-cell/mds-table-cell.js +2 -1
  643. package/dist/collection/components/mds-table-cell/pattern.md +1 -7
  644. package/dist/collection/components/mds-table-footer/AGENTS.md +1 -1
  645. package/dist/collection/components/mds-table-footer/antipattern.md +2 -2
  646. package/dist/collection/components/mds-table-footer/documentation.json +7 -3
  647. package/dist/collection/components/mds-table-footer/mds-table-footer.js +2 -1
  648. package/dist/collection/components/mds-table-footer/pattern.md +2 -4
  649. package/dist/collection/components/mds-table-header/AGENTS.md +1 -1
  650. package/dist/collection/components/mds-table-header/documentation.json +5 -1
  651. package/dist/collection/components/mds-table-header/mds-table-header.js +2 -1
  652. package/dist/collection/components/mds-table-header-cell/AGENTS.md +1 -1
  653. package/dist/collection/components/mds-table-header-cell/documentation.json +5 -1
  654. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +2 -1
  655. package/dist/collection/components/mds-table-row/AGENTS.md +2 -8
  656. package/dist/collection/components/mds-table-row/antipattern.md +4 -5
  657. package/dist/collection/components/mds-table-row/documentation.json +17 -8
  658. package/dist/collection/components/mds-table-row/mds-table-row.js +4 -3
  659. package/dist/collection/components/mds-table-row/pattern.md +5 -8
  660. package/dist/collection/components/mds-text/AGENTS.md +3 -3
  661. package/dist/collection/components/mds-text/antipattern.md +1 -2
  662. package/dist/collection/components/mds-text/documentation.json +17 -8
  663. package/dist/collection/components/mds-text/mds-text.css +3 -3
  664. package/dist/collection/components/mds-text/mds-text.js +2 -1
  665. package/dist/collection/components/mds-text/pattern.md +0 -11
  666. package/dist/collection/components/mds-toast/AGENTS.md +3 -3
  667. package/dist/collection/components/mds-toast/antipattern.md +2 -2
  668. package/dist/collection/components/mds-toast/documentation.json +19 -9
  669. package/dist/collection/components/mds-toast/mds-toast.css +4 -4
  670. package/dist/collection/components/mds-toast/mds-toast.js +2 -1
  671. package/dist/collection/components/mds-toast/pattern.md +2 -3
  672. package/dist/collection/components/mds-toast-region/AGENTS.md +1 -1
  673. package/dist/collection/components/mds-toast-region/documentation.json +7 -2
  674. package/dist/collection/components/mds-toast-region/mds-toast-region.css +1 -1
  675. package/dist/collection/components/mds-toast-region/mds-toast-region.js +2 -1
  676. package/dist/collection/components/mds-tooltip/AGENTS.md +3 -8
  677. package/dist/collection/components/mds-tooltip/antipattern.md +1 -1
  678. package/dist/collection/components/mds-tooltip/documentation.json +27 -13
  679. package/dist/collection/components/mds-tooltip/mds-tooltip.css +5 -5
  680. package/dist/collection/components/mds-tooltip/mds-tooltip.js +2 -1
  681. package/dist/collection/components/mds-tooltip/pattern.md +1 -3
  682. package/dist/collection/components/mds-tree/AGENTS.md +3 -28
  683. package/dist/collection/components/mds-tree/antipattern.md +3 -4
  684. package/dist/collection/components/mds-tree/documentation.json +63 -31
  685. package/dist/collection/components/mds-tree/mds-tree.css +1 -1
  686. package/dist/collection/components/mds-tree/mds-tree.js +2 -1
  687. package/dist/collection/components/mds-tree/pattern.md +3 -9
  688. package/dist/collection/components/mds-tree-item/AGENTS.md +2 -33
  689. package/dist/collection/components/mds-tree-item/antipattern.md +1 -5
  690. package/dist/collection/components/mds-tree-item/documentation.json +67 -33
  691. package/dist/collection/components/mds-tree-item/mds-tree-item.js +2 -1
  692. package/dist/collection/components/mds-tree-item/pattern.md +5 -10
  693. package/dist/collection/components/mds-url-view/AGENTS.md +3 -2
  694. package/dist/collection/components/mds-url-view/antipattern.md +1 -2
  695. package/dist/collection/components/mds-url-view/documentation.json +19 -9
  696. package/dist/collection/components/mds-url-view/mds-url-view.css +4 -4
  697. package/dist/collection/components/mds-url-view/mds-url-view.js +4 -1
  698. package/dist/collection/components/mds-url-view/pattern.md +1 -2
  699. package/dist/collection/components/mds-usage/AGENTS.md +2 -6
  700. package/dist/collection/components/mds-usage/antipattern.md +6 -4
  701. package/dist/collection/components/mds-usage/documentation.json +13 -6
  702. package/dist/collection/components/mds-usage/mds-usage.js +2 -1
  703. package/dist/collection/components/mds-usage/pattern.md +10 -6
  704. package/dist/collection/components/mds-video-wall/AGENTS.md +3 -4
  705. package/dist/collection/components/mds-video-wall/antipattern.md +5 -5
  706. package/dist/collection/components/mds-video-wall/documentation.json +15 -7
  707. package/dist/collection/components/mds-video-wall/mds-video-wall.css +1 -1
  708. package/dist/collection/components/mds-video-wall/mds-video-wall.js +2 -1
  709. package/dist/collection/components/mds-video-wall/pattern.md +2 -4
  710. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  711. package/dist/collection/components/mds-zero/antipattern.md +6 -6
  712. package/dist/collection/components/mds-zero/documentation.json +9 -4
  713. package/dist/collection/components/mds-zero/mds-zero.css +1 -1
  714. package/dist/collection/components/mds-zero/mds-zero.js +2 -1
  715. package/dist/collection/components/mds-zero/pattern.md +3 -3
  716. package/dist/components/index.d.ts +2 -0
  717. package/dist/components/index.js +1 -1
  718. package/dist/components/mds-accordion-item.js +1 -1
  719. package/dist/components/mds-accordion-timer-item.js +1 -1
  720. package/dist/components/mds-accordion-timer.js +1 -1
  721. package/dist/components/mds-accordion.js +1 -1
  722. package/dist/components/mds-author.js +1 -1
  723. package/dist/components/mds-avatar-stack-item.js +1 -1
  724. package/dist/components/mds-avatar-stack.js +1 -1
  725. package/dist/components/mds-avatar.js +1 -1
  726. package/dist/components/mds-badge.js +1 -1
  727. package/dist/components/mds-banner.js +1 -1
  728. package/dist/components/mds-benchmark-bar.js +1 -1
  729. package/dist/components/mds-bibliography.js +1 -1
  730. package/dist/components/mds-book.d.ts +11 -0
  731. package/dist/components/mds-book.js +1 -0
  732. package/dist/components/mds-breadcrumb-item.js +1 -1
  733. package/dist/components/mds-breadcrumb.js +1 -1
  734. package/dist/components/mds-button-dropdown.js +1 -1
  735. package/dist/components/mds-button-group.js +1 -1
  736. package/dist/components/mds-button.js +1 -1
  737. package/dist/components/mds-calendar-cell.js +1 -1
  738. package/dist/components/mds-calendar.js +1 -1
  739. package/dist/components/mds-card-content.js +1 -1
  740. package/dist/components/mds-card-footer.js +1 -1
  741. package/dist/components/mds-card-header.js +1 -1
  742. package/dist/components/mds-card-media.js +1 -1
  743. package/dist/components/mds-card.js +1 -1
  744. package/dist/components/mds-chip.js +1 -1
  745. package/dist/components/mds-details.js +1 -1
  746. package/dist/components/mds-dropdown.js +1 -1
  747. package/dist/components/mds-emoji.js +2 -2
  748. package/dist/components/mds-entity.js +1 -1
  749. package/dist/components/mds-file-preview.js +1 -1
  750. package/dist/components/mds-file.js +1 -1
  751. package/dist/components/mds-filter-item.js +1 -1
  752. package/dist/components/mds-filter.js +1 -1
  753. package/dist/components/mds-header-bar.js +1 -1
  754. package/dist/components/mds-header.js +1 -1
  755. package/dist/components/mds-help.js +1 -1
  756. package/dist/components/mds-horizontal-scroll.js +1 -1
  757. package/dist/components/mds-hr.js +1 -1
  758. package/dist/components/mds-icon.js +1 -1
  759. package/dist/components/mds-img.js +1 -1
  760. package/dist/components/mds-input-date-range-preselection.js +1 -1
  761. package/dist/components/mds-input-date-range.js +1 -1
  762. package/dist/components/mds-input-date.js +1 -1
  763. package/dist/components/mds-input-field.js +1 -1
  764. package/dist/components/mds-input-otp.js +1 -1
  765. package/dist/components/mds-input-range.js +1 -1
  766. package/dist/components/mds-input-select.js +1 -1
  767. package/dist/components/mds-input-switch.js +1 -1
  768. package/dist/components/mds-input-tip-item.js +1 -1
  769. package/dist/components/mds-input-tip.js +1 -1
  770. package/dist/components/mds-input-upload.js +1 -1
  771. package/dist/components/mds-input.js +1 -1
  772. package/dist/components/mds-keyboard-key.js +1 -1
  773. package/dist/components/mds-keyboard.js +1 -1
  774. package/dist/components/mds-kpi-item.js +1 -1
  775. package/dist/components/mds-kpi.js +1 -1
  776. package/dist/components/mds-label.js +1 -1
  777. package/dist/components/mds-link.js +1 -1
  778. package/dist/components/mds-list-item.js +1 -1
  779. package/dist/components/mds-list.js +1 -1
  780. package/dist/components/mds-mention.js +1 -1
  781. package/dist/components/mds-modal.js +1 -1
  782. package/dist/components/mds-note.js +1 -1
  783. package/dist/components/mds-notification.js +1 -1
  784. package/dist/components/mds-paginator-item.js +1 -1
  785. package/dist/components/mds-paginator.js +1 -1
  786. package/dist/components/mds-policy-ai.js +1 -1
  787. package/dist/components/mds-pref-animation.js +1 -1
  788. package/dist/components/mds-pref-consumption.js +1 -1
  789. package/dist/components/mds-pref-contrast.js +1 -1
  790. package/dist/components/mds-pref-language-item.js +1 -1
  791. package/dist/components/mds-pref-language.js +1 -1
  792. package/dist/components/mds-pref-mode.js +1 -1
  793. package/dist/components/mds-pref-theme-item.js +1 -1
  794. package/dist/components/mds-pref-theme.js +1 -1
  795. package/dist/components/mds-pref.js +1 -1
  796. package/dist/components/mds-price-table-features-cell.js +1 -1
  797. package/dist/components/mds-price-table-features-row.js +1 -1
  798. package/dist/components/mds-price-table-features.js +1 -1
  799. package/dist/components/mds-price-table-header.js +1 -1
  800. package/dist/components/mds-price-table-list-item.js +1 -1
  801. package/dist/components/mds-price-table-list.js +1 -1
  802. package/dist/components/mds-price-table.js +1 -1
  803. package/dist/components/mds-progress.js +1 -1
  804. package/dist/components/mds-push-notification-item.js +1 -1
  805. package/dist/components/mds-push-notification.js +1 -1
  806. package/dist/components/mds-quote.js +1 -1
  807. package/dist/components/mds-radial-menu-item.js +1 -1
  808. package/dist/components/mds-radial-menu.js +1 -1
  809. package/dist/components/mds-radial-progress.js +1 -1
  810. package/dist/components/mds-separator.js +1 -1
  811. package/dist/components/mds-spinner.js +1 -1
  812. package/dist/components/mds-status-bar.js +1 -1
  813. package/dist/components/mds-stepper-bar-item.js +1 -1
  814. package/dist/components/mds-stepper-bar.js +1 -1
  815. package/dist/components/mds-tab-bar-item.js +1 -1
  816. package/dist/components/mds-tab-bar.js +1 -1
  817. package/dist/components/mds-tab-item.js +1 -1
  818. package/dist/components/mds-tab.js +1 -1
  819. package/dist/components/mds-table-body.js +1 -1
  820. package/dist/components/mds-table-cell.js +1 -1
  821. package/dist/components/mds-table-footer.js +1 -1
  822. package/dist/components/mds-table-header-cell.js +1 -1
  823. package/dist/components/mds-table-header.js +1 -1
  824. package/dist/components/mds-table-row.js +1 -1
  825. package/dist/components/mds-table.js +1 -1
  826. package/dist/components/mds-text.js +1 -1
  827. package/dist/components/mds-toast-region.js +1 -1
  828. package/dist/components/mds-toast.js +1 -1
  829. package/dist/components/mds-tooltip.js +1 -1
  830. package/dist/components/mds-tree-item.js +1 -1
  831. package/dist/components/mds-tree.js +1 -1
  832. package/dist/components/mds-url-view.js +1 -1
  833. package/dist/components/mds-usage.js +1 -1
  834. package/dist/components/mds-video-wall.js +1 -1
  835. package/dist/components/mds-zero.js +1 -1
  836. package/dist/components/p-B8hgyXdE.js +1 -0
  837. package/dist/components/{p-DkUdrGHq.js → p-BBO_llcO.js} +1 -1
  838. package/dist/components/{p-nsbhb0lz.js → p-BM7joOdq.js} +1 -1
  839. package/dist/components/{p-DNeEn8Rr.js → p-BMIaZ4HY.js} +1 -1
  840. package/dist/components/{p-BwJQB6rG.js → p-BOJQ3tkp.js} +1 -1
  841. package/dist/components/{p-DCrdKrky.js → p-BU1O2DcC.js} +1 -1
  842. package/dist/components/{p-Cd8id3Br.js → p-Bo6ezD1p.js} +1 -1
  843. package/dist/components/p-C0H8bZpf.js +1 -0
  844. package/dist/components/{p-s1CktmPS.js → p-C1YH20BL.js} +1 -1
  845. package/dist/components/{p-Cmn1DJAB.js → p-CEw7GvM-.js} +1 -1
  846. package/dist/components/{p-D-DdDIb9.js → p-CNUWS_Mg.js} +1 -1
  847. package/dist/components/{p-uqwixjju.js → p-CNpL55c-.js} +1 -1
  848. package/dist/components/{p-DnySYX0L.js → p-CV7wjM1c.js} +1 -1
  849. package/dist/components/{p-BU3bsIX2.js → p-CWSIl1jl.js} +1 -1
  850. package/dist/components/{p-C99SMdU_.js → p-CYK2Xr_v.js} +1 -1
  851. package/dist/components/{p-B8x-d2fx.js → p-CZjwSwe5.js} +1 -1
  852. package/dist/components/p-Czqtt8kO.js +1 -0
  853. package/dist/components/{p-Dm-OUwDe.js → p-DD2muCqG.js} +1 -1
  854. package/dist/components/{p-ZuubAcA3.js → p-DDTJwlAd.js} +1 -1
  855. package/dist/components/{p-DF3PrYBI.js → p-DJ401QTd.js} +1 -1
  856. package/dist/components/{p-BbK4qeM7.js → p-DMyL4CYh.js} +1 -1
  857. package/dist/components/{p-DiUUZ7ZA.js → p-DTtmr_Y9.js} +1 -1
  858. package/dist/components/{p-CfQETwAK.js → p-DbVGGhs_.js} +1 -1
  859. package/dist/components/{p-C4XdTZQ-.js → p-DccBbfK8.js} +1 -1
  860. package/dist/components/{p-CNZ8_QvE.js → p-H0YXZ5fD.js} +2 -2
  861. package/dist/components/p-IaXq1Xsc.js +1 -0
  862. package/dist/components/{p-ClPv-Ljc.js → p-M8dGB4KH.js} +1 -1
  863. package/dist/components/{p-C1CTahjH.js → p-TNn_HE5x.js} +1 -1
  864. package/dist/components/{p-CNF3u0Li.js → p-aujz-VM9.js} +1 -1
  865. package/dist/components/{p-CSxW5f2f.js → p-e9NGNm7d.js} +1 -1
  866. package/dist/components/{p-D2d9eOLi.js → p-kZBPId_x.js} +1 -1
  867. package/dist/components/{p-CLe_N2_H.js → p-qnCVkeGX.js} +1 -1
  868. package/dist/documentation.json +2616 -921
  869. package/dist/esm/{index-D2_gI0qp.js → index-BJVvHlvf.js} +1 -1
  870. package/dist/esm/index-CvLLN-QH.js +4 -0
  871. package/dist/esm/loader.js +1 -1
  872. package/dist/esm/{locale-BQmO6K_S.js → locale-B6cOkl4I.js} +12 -6
  873. package/dist/esm/magma-components.js +1 -1
  874. package/dist/esm/mds-accordion-item.entry.js +1 -1
  875. package/dist/esm/mds-accordion-timer-item.entry.js +1 -1
  876. package/dist/esm/mds-accordion-timer.entry.js +1 -1
  877. package/dist/esm/mds-accordion.entry.js +1 -1
  878. package/dist/esm/mds-author.entry.js +1 -1
  879. package/dist/esm/mds-avatar-stack-item.entry.js +1 -1
  880. package/dist/esm/mds-avatar-stack.entry.js +1 -1
  881. package/dist/esm/mds-avatar.entry.js +1 -1
  882. package/dist/esm/mds-badge.entry.js +1 -1
  883. package/dist/esm/mds-banner_3.entry.js +4 -4
  884. package/dist/esm/mds-benchmark-bar.entry.js +1 -1
  885. package/dist/esm/mds-bibliography.entry.js +1 -1
  886. package/dist/esm/mds-book.entry.js +701 -0
  887. package/dist/esm/mds-breadcrumb-item.entry.js +1 -1
  888. package/dist/esm/mds-breadcrumb.entry.js +2 -2
  889. package/dist/esm/mds-button-dropdown.entry.js +2 -2
  890. package/dist/esm/mds-button-group.entry.js +1 -1
  891. package/dist/esm/mds-button_3.entry.js +6 -6
  892. package/dist/esm/mds-calendar_2.entry.js +7 -7
  893. package/dist/esm/mds-card-content.entry.js +1 -1
  894. package/dist/esm/mds-card-footer.entry.js +1 -1
  895. package/dist/esm/mds-card-header.entry.js +1 -1
  896. package/dist/esm/mds-card-media.entry.js +1 -1
  897. package/dist/esm/mds-card.entry.js +1 -1
  898. package/dist/esm/mds-details.entry.js +1 -1
  899. package/dist/esm/mds-dropdown.entry.js +2 -2
  900. package/dist/esm/mds-emoji.entry.js +2 -2
  901. package/dist/esm/mds-entity.entry.js +1 -1
  902. package/dist/esm/mds-file-preview.entry.js +3 -3
  903. package/dist/esm/mds-file.entry.js +2 -2
  904. package/dist/esm/mds-filter-item.entry.js +2 -2
  905. package/dist/esm/mds-filter.entry.js +2 -2
  906. package/dist/esm/mds-header-bar.entry.js +2 -2
  907. package/dist/esm/mds-header.entry.js +2 -2
  908. package/dist/esm/mds-horizontal-scroll.entry.js +2 -2
  909. package/dist/esm/mds-hr.entry.js +1 -1
  910. package/dist/esm/mds-img.entry.js +1 -1
  911. package/dist/esm/mds-input-date-range-preselection.entry.js +1 -1
  912. package/dist/esm/mds-input-date-range.entry.js +3 -3
  913. package/dist/esm/mds-input-date.entry.js +4 -4
  914. package/dist/esm/mds-input-field.entry.js +1 -1
  915. package/dist/esm/mds-input-otp.entry.js +2 -2
  916. package/dist/esm/mds-input-range.entry.js +2 -2
  917. package/dist/esm/mds-input-select.entry.js +9 -5
  918. package/dist/esm/mds-input-switch_2.entry.js +3 -3
  919. package/dist/esm/mds-input-tip_2.entry.js +4 -4
  920. package/dist/esm/mds-input-upload.entry.js +6 -6
  921. package/dist/esm/mds-input.entry.js +154 -37
  922. package/dist/esm/mds-keyboard-key.entry.js +3 -3
  923. package/dist/esm/mds-keyboard.entry.js +8 -4
  924. package/dist/esm/mds-kpi-item.entry.js +1 -1
  925. package/dist/esm/mds-kpi.entry.js +1 -1
  926. package/dist/esm/mds-label.entry.js +2 -2
  927. package/dist/esm/mds-link.entry.js +4 -4
  928. package/dist/esm/mds-list-item.entry.js +1 -1
  929. package/dist/esm/mds-list.entry.js +1 -1
  930. package/dist/esm/mds-mention.entry.js +2 -2
  931. package/dist/esm/mds-modal.entry.js +4 -4
  932. package/dist/esm/mds-note.entry.js +2 -2
  933. package/dist/esm/mds-notification.entry.js +1 -1
  934. package/dist/esm/mds-paginator-item.entry.js +1 -1
  935. package/dist/esm/mds-paginator.entry.js +2 -2
  936. package/dist/esm/mds-policy-ai.entry.js +2 -2
  937. package/dist/esm/mds-pref-animation.entry.js +2 -2
  938. package/dist/esm/mds-pref-consumption.entry.js +2 -2
  939. package/dist/esm/mds-pref-contrast.entry.js +2 -2
  940. package/dist/esm/mds-pref-language-item.entry.js +2 -2
  941. package/dist/esm/mds-pref-language.entry.js +2 -2
  942. package/dist/esm/mds-pref-mode.entry.js +2 -2
  943. package/dist/esm/mds-pref-theme-item.entry.js +1 -1
  944. package/dist/esm/mds-pref-theme.entry.js +2 -2
  945. package/dist/esm/mds-pref.entry.js +2 -2
  946. package/dist/esm/mds-price-table-features-cell.entry.js +1 -1
  947. package/dist/esm/mds-price-table-features-row.entry.js +1 -1
  948. package/dist/esm/mds-price-table-features.entry.js +1 -1
  949. package/dist/esm/mds-price-table-header.entry.js +1 -1
  950. package/dist/esm/mds-price-table-list-item.entry.js +1 -1
  951. package/dist/esm/mds-price-table-list.entry.js +1 -1
  952. package/dist/esm/mds-price-table.entry.js +1 -1
  953. package/dist/esm/mds-progress_2.entry.js +2 -2
  954. package/dist/esm/mds-push-notification-item.entry.js +3 -3
  955. package/dist/esm/mds-push-notification.entry.js +3 -3
  956. package/dist/esm/mds-quote.entry.js +1 -1
  957. package/dist/esm/mds-radial-menu-item.entry.js +1 -1
  958. package/dist/esm/mds-radial-menu.entry.js +2 -2
  959. package/dist/esm/mds-separator.entry.js +1 -1
  960. package/dist/esm/mds-status-bar.entry.js +2 -2
  961. package/dist/esm/mds-stepper-bar-item.entry.js +7 -5
  962. package/dist/esm/mds-stepper-bar.entry.js +1 -1
  963. package/dist/esm/mds-tab-bar-item.entry.js +1 -1
  964. package/dist/esm/mds-tab-bar.entry.js +1 -1
  965. package/dist/esm/mds-tab_2.entry.js +4 -4
  966. package/dist/esm/mds-table-body.entry.js +1 -1
  967. package/dist/esm/mds-table-footer.entry.js +1 -1
  968. package/dist/esm/mds-table-header-cell.entry.js +1 -1
  969. package/dist/esm/mds-table-header.entry.js +2 -2
  970. package/dist/esm/mds-table-row.entry.js +3 -3
  971. package/dist/esm/mds-table.entry.js +2 -2
  972. package/dist/esm/mds-text.entry.js +1 -1
  973. package/dist/esm/mds-toast-region.entry.js +1 -1
  974. package/dist/esm/mds-toast.entry.js +2 -2
  975. package/dist/esm/mds-tooltip.entry.js +2 -2
  976. package/dist/esm/mds-tree-item.entry.js +2 -2
  977. package/dist/esm/mds-tree.entry.js +1 -1
  978. package/dist/esm/mds-url-view.entry.js +2 -2
  979. package/dist/esm/mds-usage.entry.js +2 -2
  980. package/dist/esm/mds-video-wall.entry.js +1 -1
  981. package/dist/esm/mds-zero.entry.js +1 -1
  982. package/dist/esm-es5/{index-D2_gI0qp.js → index-BJVvHlvf.js} +1 -1
  983. package/dist/esm-es5/index-CvLLN-QH.js +8 -6
  984. package/dist/esm-es5/loader.js +1 -1
  985. package/dist/esm-es5/{locale-BQmO6K_S.js → locale-B6cOkl4I.js} +22 -18
  986. package/dist/esm-es5/magma-components.js +2 -2
  987. package/dist/esm-es5/mds-accordion-item.entry.js +1 -1
  988. package/dist/esm-es5/mds-accordion-timer-item.entry.js +1 -1
  989. package/dist/esm-es5/mds-accordion-timer.entry.js +1 -1
  990. package/dist/esm-es5/mds-accordion.entry.js +2 -2
  991. package/dist/esm-es5/mds-author.entry.js +1 -1
  992. package/dist/esm-es5/mds-avatar-stack-item.entry.js +1 -1
  993. package/dist/esm-es5/mds-avatar-stack.entry.js +1 -1
  994. package/dist/esm-es5/mds-avatar.entry.js +5 -5
  995. package/dist/esm-es5/mds-badge.entry.js +1 -1
  996. package/dist/esm-es5/mds-banner_3.entry.js +4 -4
  997. package/dist/esm-es5/mds-benchmark-bar.entry.js +3 -3
  998. package/dist/esm-es5/mds-bibliography.entry.js +2 -2
  999. package/dist/esm-es5/mds-book.entry.js +207 -0
  1000. package/dist/esm-es5/mds-breadcrumb-item.entry.js +1 -1
  1001. package/dist/esm-es5/mds-breadcrumb.entry.js +4 -4
  1002. package/dist/esm-es5/mds-button-dropdown.entry.js +2 -2
  1003. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  1004. package/dist/esm-es5/mds-button_3.entry.js +5 -5
  1005. package/dist/esm-es5/mds-calendar_2.entry.js +4 -4
  1006. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  1007. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  1008. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  1009. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  1010. package/dist/esm-es5/mds-card.entry.js +1 -1
  1011. package/dist/esm-es5/mds-details.entry.js +1 -1
  1012. package/dist/esm-es5/mds-dropdown.entry.js +1 -1
  1013. package/dist/esm-es5/mds-emoji.entry.js +2 -2
  1014. package/dist/esm-es5/mds-entity.entry.js +1 -1
  1015. package/dist/esm-es5/mds-file-preview.entry.js +8 -8
  1016. package/dist/esm-es5/mds-file.entry.js +2 -2
  1017. package/dist/esm-es5/mds-filter-item.entry.js +2 -2
  1018. package/dist/esm-es5/mds-filter.entry.js +2 -2
  1019. package/dist/esm-es5/mds-header-bar.entry.js +2 -2
  1020. package/dist/esm-es5/mds-header.entry.js +2 -2
  1021. package/dist/esm-es5/mds-horizontal-scroll.entry.js +2 -2
  1022. package/dist/esm-es5/mds-hr.entry.js +1 -1
  1023. package/dist/esm-es5/mds-img.entry.js +1 -1
  1024. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +1 -1
  1025. package/dist/esm-es5/mds-input-date-range.entry.js +3 -3
  1026. package/dist/esm-es5/mds-input-date.entry.js +3 -3
  1027. package/dist/esm-es5/mds-input-field.entry.js +1 -1
  1028. package/dist/esm-es5/mds-input-otp.entry.js +2 -2
  1029. package/dist/esm-es5/mds-input-range.entry.js +7 -7
  1030. package/dist/esm-es5/mds-input-select.entry.js +5 -4
  1031. package/dist/esm-es5/mds-input-switch_2.entry.js +2 -2
  1032. package/dist/esm-es5/mds-input-tip_2.entry.js +3 -3
  1033. package/dist/esm-es5/mds-input-upload.entry.js +2 -2
  1034. package/dist/esm-es5/mds-input.entry.js +53 -50
  1035. package/dist/esm-es5/mds-keyboard-key.entry.js +2 -2
  1036. package/dist/esm-es5/mds-keyboard.entry.js +6 -3
  1037. package/dist/esm-es5/mds-kpi-item.entry.js +3 -3
  1038. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  1039. package/dist/esm-es5/mds-label.entry.js +2 -2
  1040. package/dist/esm-es5/mds-link.entry.js +2 -2
  1041. package/dist/esm-es5/mds-list-item.entry.js +1 -1
  1042. package/dist/esm-es5/mds-list.entry.js +1 -1
  1043. package/dist/esm-es5/mds-mention.entry.js +2 -2
  1044. package/dist/esm-es5/mds-modal.entry.js +2 -2
  1045. package/dist/esm-es5/mds-note.entry.js +2 -2
  1046. package/dist/esm-es5/mds-notification.entry.js +1 -1
  1047. package/dist/esm-es5/mds-paginator-item.entry.js +1 -1
  1048. package/dist/esm-es5/mds-paginator.entry.js +3 -3
  1049. package/dist/esm-es5/mds-policy-ai.entry.js +2 -2
  1050. package/dist/esm-es5/mds-pref-animation.entry.js +2 -2
  1051. package/dist/esm-es5/mds-pref-consumption.entry.js +2 -2
  1052. package/dist/esm-es5/mds-pref-contrast.entry.js +2 -2
  1053. package/dist/esm-es5/mds-pref-language-item.entry.js +2 -2
  1054. package/dist/esm-es5/mds-pref-language.entry.js +2 -2
  1055. package/dist/esm-es5/mds-pref-mode.entry.js +2 -2
  1056. package/dist/esm-es5/mds-pref-theme-item.entry.js +3 -3
  1057. package/dist/esm-es5/mds-pref-theme.entry.js +6 -6
  1058. package/dist/esm-es5/mds-pref.entry.js +2 -2
  1059. package/dist/esm-es5/mds-price-table-features-cell.entry.js +1 -1
  1060. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  1061. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  1062. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  1063. package/dist/esm-es5/mds-price-table-list-item.entry.js +1 -1
  1064. package/dist/esm-es5/mds-price-table-list.entry.js +1 -1
  1065. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  1066. package/dist/esm-es5/mds-progress_2.entry.js +2 -2
  1067. package/dist/esm-es5/mds-push-notification-item.entry.js +2 -2
  1068. package/dist/esm-es5/mds-push-notification.entry.js +2 -2
  1069. package/dist/esm-es5/mds-quote.entry.js +1 -1
  1070. package/dist/esm-es5/mds-radial-menu-item.entry.js +1 -1
  1071. package/dist/esm-es5/mds-radial-menu.entry.js +2 -2
  1072. package/dist/esm-es5/mds-separator.entry.js +1 -1
  1073. package/dist/esm-es5/mds-status-bar.entry.js +2 -2
  1074. package/dist/esm-es5/mds-stepper-bar-item.entry.js +6 -3
  1075. package/dist/esm-es5/mds-stepper-bar.entry.js +1 -1
  1076. package/dist/esm-es5/mds-tab-bar-item.entry.js +1 -1
  1077. package/dist/esm-es5/mds-tab-bar.entry.js +1 -1
  1078. package/dist/esm-es5/mds-tab_2.entry.js +3 -3
  1079. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  1080. package/dist/esm-es5/mds-table-footer.entry.js +1 -1
  1081. package/dist/esm-es5/mds-table-header-cell.entry.js +1 -1
  1082. package/dist/esm-es5/mds-table-header.entry.js +4 -4
  1083. package/dist/esm-es5/mds-table-row.entry.js +2 -2
  1084. package/dist/esm-es5/mds-table.entry.js +2 -2
  1085. package/dist/esm-es5/mds-text.entry.js +1 -1
  1086. package/dist/esm-es5/mds-toast-region.entry.js +1 -1
  1087. package/dist/esm-es5/mds-toast.entry.js +2 -2
  1088. package/dist/esm-es5/mds-tooltip.entry.js +2 -2
  1089. package/dist/esm-es5/mds-tree-item.entry.js +2 -2
  1090. package/dist/esm-es5/mds-tree.entry.js +1 -1
  1091. package/dist/esm-es5/mds-url-view.entry.js +2 -2
  1092. package/dist/esm-es5/mds-usage.entry.js +2 -2
  1093. package/dist/esm-es5/mds-video-wall.entry.js +1 -1
  1094. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1095. package/dist/hydrate/index.js +1228 -207
  1096. package/dist/hydrate/index.mjs +1228 -207
  1097. package/dist/lint/core/checks.d.ts +26 -0
  1098. package/dist/lint/core/checks.js +135 -0
  1099. package/dist/lint/core/colors.d.ts +2 -0
  1100. package/dist/lint/core/colors.js +40 -0
  1101. package/dist/lint/core/data.d.ts +82 -0
  1102. package/dist/lint/core/data.js +171 -0
  1103. package/dist/lint/core/element.d.ts +55 -0
  1104. package/dist/lint/core/element.js +19 -0
  1105. package/dist/lint/eslint/adapters.d.ts +53 -0
  1106. package/dist/lint/eslint/adapters.js +217 -0
  1107. package/dist/lint/eslint/index.d.ts +7 -0
  1108. package/dist/lint/eslint/index.js +86 -0
  1109. package/dist/lint/index.d.ts +4 -0
  1110. package/dist/lint/index.js +10 -0
  1111. package/dist/lint/mcp/checks.d.ts +15 -0
  1112. package/dist/lint/mcp/checks.js +407 -0
  1113. package/dist/lint/mcp/cli.d.ts +2 -0
  1114. package/dist/lint/mcp/cli.js +29 -0
  1115. package/dist/lint/mcp/color.d.ts +12 -0
  1116. package/dist/lint/mcp/color.js +87 -0
  1117. package/dist/lint/mcp/components.d.ts +5 -0
  1118. package/dist/lint/mcp/components.js +362 -0
  1119. package/dist/lint/mcp/context.d.ts +25 -0
  1120. package/dist/lint/mcp/context.js +87 -0
  1121. package/dist/lint/mcp/guides.d.ts +3 -0
  1122. package/dist/lint/mcp/guides.js +137 -0
  1123. package/dist/lint/mcp/icon.svg +11 -0
  1124. package/dist/lint/mcp/icons.d.ts +3 -0
  1125. package/dist/lint/mcp/icons.js +170 -0
  1126. package/dist/lint/mcp/protocol.d.ts +42 -0
  1127. package/dist/lint/mcp/protocol.js +106 -0
  1128. package/dist/lint/mcp/server.d.ts +20 -0
  1129. package/dist/lint/mcp/server.js +67 -0
  1130. package/dist/lint/mcp/tokens.d.ts +22 -0
  1131. package/dist/lint/mcp/tokens.js +507 -0
  1132. package/dist/lint/package.json +3 -0
  1133. package/dist/lint/stylelint/index.d.ts +3 -0
  1134. package/dist/lint/stylelint/index.js +137 -0
  1135. package/dist/lint/stylelint/recommended.d.ts +3 -0
  1136. package/dist/lint/stylelint/recommended.js +10 -0
  1137. package/dist/lint/stylelint/strict.d.ts +3 -0
  1138. package/dist/lint/stylelint/strict.js +10 -0
  1139. package/dist/magma-components/magma-components.esm.js +1 -1
  1140. package/dist/magma-components/{p-26451eb6.entry.js → p-00aa9a51.entry.js} +1 -1
  1141. package/dist/magma-components/{p-5533b60d.system.entry.js → p-00acb2e1.system.entry.js} +3 -3
  1142. package/dist/magma-components/{p-4bc3335f.system.entry.js → p-037126b7.system.entry.js} +1 -1
  1143. package/dist/magma-components/{p-e5d41024.system.entry.js → p-03da0376.system.entry.js} +1 -1
  1144. package/dist/magma-components/{p-25a6e977.entry.js → p-0417391b.entry.js} +1 -1
  1145. package/dist/magma-components/{p-377d0661.entry.js → p-05ef91a5.entry.js} +1 -1
  1146. package/dist/magma-components/{p-336f56a4.entry.js → p-07d35da6.entry.js} +1 -1
  1147. package/dist/magma-components/{p-f4d80d9a.entry.js → p-09c80fdb.entry.js} +1 -1
  1148. package/dist/magma-components/{p-5cfa0dce.entry.js → p-0b0ca53c.entry.js} +1 -1
  1149. package/dist/magma-components/{p-617370e7.system.entry.js → p-0babf674.system.entry.js} +7 -7
  1150. package/dist/magma-components/{p-29162c98.entry.js → p-0d90c991.entry.js} +1 -1
  1151. package/dist/magma-components/{p-9745dc51.entry.js → p-103465cf.entry.js} +1 -1
  1152. package/dist/magma-components/{p-919f9dce.entry.js → p-10983da0.entry.js} +1 -1
  1153. package/dist/magma-components/{p-52d905fe.system.entry.js → p-109926ce.system.entry.js} +2 -2
  1154. package/dist/magma-components/{p-70d38284.entry.js → p-14b13850.entry.js} +1 -1
  1155. package/dist/magma-components/{p-bf0cb77d.system.entry.js → p-154ba354.system.entry.js} +2 -2
  1156. package/dist/magma-components/{p-73833405.entry.js → p-160cd923.entry.js} +1 -1
  1157. package/dist/magma-components/{p-5ef0fb69.system.entry.js → p-1685e74c.system.entry.js} +1 -1
  1158. package/dist/magma-components/p-1748ca8b.system.entry.js +1 -0
  1159. package/dist/magma-components/{p-729c89f9.system.entry.js → p-17a43cb6.system.entry.js} +2 -2
  1160. package/dist/magma-components/p-17ccfc01.system.entry.js +208 -0
  1161. package/dist/magma-components/{p-f670ed20.entry.js → p-198ea5d8.entry.js} +1 -1
  1162. package/dist/magma-components/{p-d561062f.system.entry.js → p-1b415625.system.entry.js} +3 -3
  1163. package/dist/magma-components/{p-4bc47ff0.system.entry.js → p-1b67b149.system.entry.js} +2 -2
  1164. package/dist/magma-components/p-1c00d0f7.entry.js +1 -0
  1165. package/dist/magma-components/{p-05ed801b.system.entry.js → p-1cd75adf.system.entry.js} +3 -3
  1166. package/dist/magma-components/{p-244676d3.system.entry.js → p-1d8485de.system.entry.js} +4 -4
  1167. package/dist/magma-components/{p-23c057a9.entry.js → p-2006cfeb.entry.js} +1 -1
  1168. package/dist/magma-components/{p-02fe26b4.system.entry.js → p-2216f207.system.entry.js} +2 -2
  1169. package/dist/magma-components/{p-edf003f1.system.entry.js → p-22f24125.system.entry.js} +1 -1
  1170. package/dist/magma-components/{p-6560b426.system.entry.js → p-25c07b67.system.entry.js} +1 -1
  1171. package/dist/magma-components/{p-e3a65644.entry.js → p-29fbb7cf.entry.js} +1 -1
  1172. package/dist/magma-components/{p-f7147d05.entry.js → p-2a26b614.entry.js} +1 -1
  1173. package/dist/magma-components/p-2a6c2a41.entry.js +1 -0
  1174. package/dist/magma-components/{p-06fde29d.entry.js → p-2c28056d.entry.js} +1 -1
  1175. package/dist/magma-components/{p-23722401.entry.js → p-2c5e5cd1.entry.js} +1 -1
  1176. package/dist/magma-components/{p-d92ccce5.system.entry.js → p-2c7d091e.system.entry.js} +3 -3
  1177. package/dist/magma-components/{p-3abaa053.entry.js → p-2c997b47.entry.js} +1 -1
  1178. package/dist/magma-components/{p-0a8e8525.entry.js → p-2f39f4e4.entry.js} +1 -1
  1179. package/dist/magma-components/{p-02298ed0.system.entry.js → p-31370fdb.system.entry.js} +1 -1
  1180. package/dist/magma-components/{p-3df07021.system.entry.js → p-3139988c.system.entry.js} +1 -1
  1181. package/dist/magma-components/p-32418266.entry.js +1 -0
  1182. package/dist/magma-components/{p-cc9659e1.system.entry.js → p-33c80de3.system.entry.js} +1 -1
  1183. package/dist/magma-components/{p-09a7b578.system.entry.js → p-34c0e63c.system.entry.js} +1 -1
  1184. package/dist/magma-components/{p-ca1969c5.entry.js → p-354a5b47.entry.js} +1 -1
  1185. package/dist/magma-components/{p-81e02997.system.entry.js → p-35c6341a.system.entry.js} +3 -3
  1186. package/dist/magma-components/{p-b476435f.entry.js → p-379f51a6.entry.js} +1 -1
  1187. package/dist/magma-components/{p-7c217aa5.entry.js → p-381f49ea.entry.js} +1 -1
  1188. package/dist/magma-components/{p-221c2f0d.entry.js → p-384ab014.entry.js} +1 -1
  1189. package/dist/magma-components/{p-29ab84bf.system.entry.js → p-386bb24e.system.entry.js} +4 -4
  1190. package/dist/magma-components/{p-1e18fcc5.system.entry.js → p-39a2df98.system.entry.js} +1 -1
  1191. package/dist/magma-components/{p-5c4e41d3.system.entry.js → p-3a7c4314.system.entry.js} +3 -3
  1192. package/dist/magma-components/{p-e5950aee.entry.js → p-3a9a75e5.entry.js} +1 -1
  1193. package/dist/magma-components/{p-5435f2a9.entry.js → p-3b691cc3.entry.js} +1 -1
  1194. package/dist/magma-components/{p-3fd8ff0e.system.entry.js → p-3bdb541f.system.entry.js} +2 -2
  1195. package/dist/magma-components/{p-dbd34e3b.entry.js → p-3ca004c3.entry.js} +1 -1
  1196. package/dist/magma-components/{p-4776ac1f.entry.js → p-3caf6a26.entry.js} +1 -1
  1197. package/dist/magma-components/{p-1faa4f71.entry.js → p-3dccd446.entry.js} +1 -1
  1198. package/dist/magma-components/{p-396d95a1.system.entry.js → p-3dde41b0.system.entry.js} +3 -3
  1199. package/dist/magma-components/{p-6f81c9ef.system.entry.js → p-3e8e0003.system.entry.js} +2 -2
  1200. package/dist/magma-components/{p-21547758.system.entry.js → p-3f0e6729.system.entry.js} +3 -3
  1201. package/dist/magma-components/{p-481897a7.entry.js → p-42ab27de.entry.js} +1 -1
  1202. package/dist/magma-components/{p-80eea067.system.entry.js → p-430a4c4b.system.entry.js} +2 -2
  1203. package/dist/magma-components/{p-d48c40ab.system.entry.js → p-47b05fa1.system.entry.js} +1 -1
  1204. package/dist/magma-components/{p-e5eb2390.entry.js → p-47db3155.entry.js} +1 -1
  1205. package/dist/magma-components/{p-2c845743.system.entry.js → p-48f86057.system.entry.js} +1 -1
  1206. package/dist/magma-components/{p-7961c335.system.entry.js → p-4a72d72c.system.entry.js} +1 -1
  1207. package/dist/magma-components/{p-2d3b5eb5.entry.js → p-4aa94380.entry.js} +1 -1
  1208. package/dist/magma-components/{p-ab00b7b9.entry.js → p-4ab2eb7e.entry.js} +1 -1
  1209. package/dist/magma-components/{p-c3c487aa.system.entry.js → p-4bea91e1.system.entry.js} +1 -1
  1210. package/dist/magma-components/{p-f588cf9e.entry.js → p-4cd21f19.entry.js} +1 -1
  1211. package/dist/magma-components/{p-287601bb.entry.js → p-4de89d1b.entry.js} +1 -1
  1212. package/dist/magma-components/{p-23fabd66.system.entry.js → p-50c8f36c.system.entry.js} +1 -1
  1213. package/dist/magma-components/{p-d0bfdb44.system.entry.js → p-5200ab23.system.entry.js} +2 -2
  1214. package/dist/magma-components/{p-f35608b2.entry.js → p-52211fa3.entry.js} +1 -1
  1215. package/dist/magma-components/{p-74f515c3.system.entry.js → p-53981624.system.entry.js} +2 -2
  1216. package/dist/magma-components/p-53acdc6b.entry.js +1 -0
  1217. package/dist/magma-components/p-5660182a.system.entry.js +1 -0
  1218. package/dist/magma-components/{p-464e6431.entry.js → p-56c5ca6f.entry.js} +1 -1
  1219. package/dist/magma-components/p-57e92942.system.entry.js +20 -0
  1220. package/dist/magma-components/{p-63b10a6e.entry.js → p-59aa4994.entry.js} +1 -1
  1221. package/dist/magma-components/{p-9a3ddc91.entry.js → p-59f06b9c.entry.js} +1 -1
  1222. package/dist/magma-components/{p-3d95e688.system.entry.js → p-5aa78075.system.entry.js} +3 -3
  1223. package/dist/magma-components/p-5cf87a7f.entry.js +1 -0
  1224. package/dist/magma-components/{p-5da14e81.entry.js → p-5e8df58d.entry.js} +1 -1
  1225. package/dist/magma-components/{p-880f3eac.system.entry.js → p-5ed74216.system.entry.js} +1 -1
  1226. package/dist/magma-components/{p-84777b38.system.entry.js → p-5f064376.system.entry.js} +2 -2
  1227. package/dist/magma-components/{p-8173ed07.entry.js → p-60727165.entry.js} +2 -2
  1228. package/dist/magma-components/{p-278c362d.entry.js → p-6093aa8e.entry.js} +1 -1
  1229. package/dist/magma-components/{p-29450db3.entry.js → p-62d9eaca.entry.js} +1 -1
  1230. package/dist/magma-components/{p-4c6da1db.system.entry.js → p-6b402a09.system.entry.js} +9 -9
  1231. package/dist/magma-components/p-6b55c5fe.system.entry.js +1 -0
  1232. package/dist/magma-components/{p-3d162e99.system.entry.js → p-6d57674c.system.entry.js} +2 -2
  1233. package/dist/magma-components/p-6d96d223.entry.js +1 -0
  1234. package/dist/magma-components/{p-47717251.system.entry.js → p-6df26141.system.entry.js} +4 -4
  1235. package/dist/magma-components/{p-5f8db04c.system.entry.js → p-6df7da52.system.entry.js} +1 -1
  1236. package/dist/magma-components/{p-9250ec26.system.entry.js → p-6e751bcc.system.entry.js} +2 -2
  1237. package/dist/magma-components/{p-656b00df.system.entry.js → p-718d6384.system.entry.js} +8 -8
  1238. package/dist/magma-components/{p-8279056b.system.entry.js → p-71dab494.system.entry.js} +3 -3
  1239. package/dist/magma-components/{p-b5789a7c.entry.js → p-732d09b6.entry.js} +1 -1
  1240. package/dist/magma-components/{p-fac6f123.entry.js → p-73f4f67e.entry.js} +1 -1
  1241. package/dist/magma-components/{p-772c18f4.entry.js → p-785fa112.entry.js} +1 -1
  1242. package/dist/magma-components/{p-26b9f2b7.system.entry.js → p-79fd07e7.system.entry.js} +2 -2
  1243. package/dist/magma-components/{p-0033cb92.system.entry.js → p-7acbc6ea.system.entry.js} +1 -1
  1244. package/dist/magma-components/{p-67eb3881.entry.js → p-7dd0364b.entry.js} +1 -1
  1245. package/dist/magma-components/{p-cbb80188.entry.js → p-7e7391fd.entry.js} +1 -1
  1246. package/dist/magma-components/{p-f889d413.system.entry.js → p-7ec28ff1.system.entry.js} +2 -2
  1247. package/dist/magma-components/{p-71cbc840.entry.js → p-7f74ec99.entry.js} +1 -1
  1248. package/dist/magma-components/{p-0679c988.system.entry.js → p-7ffce9e8.system.entry.js} +1 -1
  1249. package/dist/magma-components/{p-06ccc40d.entry.js → p-81212e34.entry.js} +1 -1
  1250. package/dist/magma-components/{p-cf6f54e5.system.entry.js → p-8219e58f.system.entry.js} +2 -2
  1251. package/dist/magma-components/{p-860bce85.system.entry.js → p-84711ab6.system.entry.js} +3 -3
  1252. package/dist/magma-components/p-84bf333b.entry.js +1 -0
  1253. package/dist/magma-components/{p-4792ff7f.entry.js → p-84d0d701.entry.js} +1 -1
  1254. package/dist/magma-components/{p-30be5c39.entry.js → p-857ae762.entry.js} +1 -1
  1255. package/dist/magma-components/{p-8f63f1a1.system.entry.js → p-87395a4d.system.entry.js} +1 -1
  1256. package/dist/magma-components/{p-2431fbfa.system.entry.js → p-87831da2.system.entry.js} +1 -1
  1257. package/dist/magma-components/{p-e39518b4.system.entry.js → p-896310aa.system.entry.js} +2 -2
  1258. package/dist/magma-components/{p-dc1a5826.system.entry.js → p-8ac1ba5c.system.entry.js} +1 -1
  1259. package/dist/magma-components/{p-86cf87fb.entry.js → p-8b8a6662.entry.js} +1 -1
  1260. package/dist/magma-components/{p-62fc9695.entry.js → p-8d7093af.entry.js} +1 -1
  1261. package/dist/magma-components/{p-8ab9ff37.system.entry.js → p-8e15c151.system.entry.js} +1 -1
  1262. package/dist/magma-components/{p-a9ba496d.entry.js → p-8f1c529f.entry.js} +1 -1
  1263. package/dist/magma-components/{p-94289f3d.system.entry.js → p-8f1e9021.system.entry.js} +5 -5
  1264. package/dist/magma-components/{p-69abd1d1.entry.js → p-904c1222.entry.js} +1 -1
  1265. package/dist/magma-components/{p-a70fb4fb.system.entry.js → p-907f06cd.system.entry.js} +9 -9
  1266. package/dist/magma-components/{p-000c315c.entry.js → p-9332358d.entry.js} +1 -1
  1267. package/dist/magma-components/{p-2eb4efcd.system.entry.js → p-93b9d39d.system.entry.js} +2 -2
  1268. package/dist/magma-components/{p-d8ae0f02.system.entry.js → p-965e7a82.system.entry.js} +1 -1
  1269. package/dist/magma-components/{p-c50e20cf.system.entry.js → p-96dfb60e.system.entry.js} +1 -1
  1270. package/dist/magma-components/{p-835d79e5.system.entry.js → p-99bfa07e.system.entry.js} +1 -1
  1271. package/dist/magma-components/{p-3beea731.system.entry.js → p-9c408768.system.entry.js} +1 -1
  1272. package/dist/magma-components/{p-1d2220f0.system.entry.js → p-9e792bed.system.entry.js} +1 -1
  1273. package/dist/magma-components/{p-8258733b.entry.js → p-9fdd477a.entry.js} +1 -1
  1274. package/dist/magma-components/{p-f82c2b7e.system.entry.js → p-9fefa077.system.entry.js} +1 -1
  1275. package/dist/magma-components/p-B8zYiZQY.system.js +2 -2
  1276. package/dist/magma-components/{p-OOCOFWC0.system.js → p-CuHZXISO.system.js} +7 -3
  1277. package/dist/magma-components/{p-DXAjcaHM.system.js → p-CxTugGM9.system.js} +1 -1
  1278. package/dist/magma-components/{p-U5iXN1wy.js → p-Dx_cCOTw.js} +1 -1
  1279. package/dist/magma-components/{p-Raj-urIN.js → p-OafT80hV.js} +1 -1
  1280. package/dist/magma-components/{p-458eb34c.system.entry.js → p-a0d637b6.system.entry.js} +2 -2
  1281. package/dist/magma-components/p-a26c05b6.entry.js +1 -0
  1282. package/dist/magma-components/{p-ccc40c6a.system.entry.js → p-a7baf451.system.entry.js} +2 -2
  1283. package/dist/magma-components/p-ac9feb04.entry.js +1 -0
  1284. package/dist/magma-components/p-ad383f92.entry.js +1 -0
  1285. package/dist/magma-components/{p-42e50f25.system.entry.js → p-ae4736a0.system.entry.js} +4 -4
  1286. package/dist/magma-components/{p-9fc385aa.entry.js → p-b3332c5f.entry.js} +1 -1
  1287. package/dist/magma-components/{p-d37fe692.system.entry.js → p-b3e2b68a.system.entry.js} +2 -2
  1288. package/dist/magma-components/{p-808b9277.entry.js → p-b86144d4.entry.js} +1 -1
  1289. package/dist/magma-components/{p-2cbd532a.system.entry.js → p-bbde5701.system.entry.js} +2 -2
  1290. package/dist/magma-components/{p-577ae081.system.entry.js → p-bc075b3b.system.entry.js} +2 -2
  1291. package/dist/magma-components/{p-068e30a5.entry.js → p-bc19b136.entry.js} +1 -1
  1292. package/dist/magma-components/{p-254ee71d.entry.js → p-bcca26d9.entry.js} +1 -1
  1293. package/dist/magma-components/{p-fc2d1134.entry.js → p-bf35627d.entry.js} +1 -1
  1294. package/dist/magma-components/p-bfd95736.entry.js +1 -0
  1295. package/dist/magma-components/{p-6a2d67d1.system.entry.js → p-c086a5a4.system.entry.js} +1 -1
  1296. package/dist/magma-components/{p-41a0f896.entry.js → p-c27206ca.entry.js} +1 -1
  1297. package/dist/magma-components/{p-762a6b7b.entry.js → p-c2758b81.entry.js} +1 -1
  1298. package/dist/magma-components/{p-a76a9f92.system.entry.js → p-c2c693ed.system.entry.js} +2 -2
  1299. package/dist/magma-components/{p-642925b7.system.entry.js → p-c4a5ab6e.system.entry.js} +1 -1
  1300. package/dist/magma-components/{p-b23bee0c.entry.js → p-c58157cf.entry.js} +1 -1
  1301. package/dist/magma-components/{p-8a9544aa.entry.js → p-c597ad47.entry.js} +1 -1
  1302. package/dist/magma-components/{p-295d8fab.entry.js → p-c7b2ebb5.entry.js} +1 -1
  1303. package/dist/magma-components/{p-ae3bf24c.system.entry.js → p-c8b06821.system.entry.js} +2 -2
  1304. package/dist/magma-components/p-ca1143bc.entry.js +1 -0
  1305. package/dist/magma-components/p-cb88fa71.entry.js +1 -0
  1306. package/dist/magma-components/{p-471227f2.system.entry.js → p-cd783f9e.system.entry.js} +2 -2
  1307. package/dist/magma-components/{p-bd97e368.system.entry.js → p-cd955bc7.system.entry.js} +1 -1
  1308. package/dist/magma-components/{p-1f623b75.entry.js → p-ce42e251.entry.js} +1 -1
  1309. package/dist/magma-components/{p-7bf46d43.entry.js → p-cf4f4561.entry.js} +1 -1
  1310. package/dist/magma-components/{p-0d32e196.system.entry.js → p-d0a15a3a.system.entry.js} +5 -4
  1311. package/dist/magma-components/{p-96bb36b9.entry.js → p-d218ae47.entry.js} +1 -1
  1312. package/dist/magma-components/{p-b738d3c1.entry.js → p-d331ff5c.entry.js} +1 -1
  1313. package/dist/magma-components/{p-34c2daa9.system.entry.js → p-d3844c9a.system.entry.js} +4 -4
  1314. package/dist/magma-components/{p-837d31b8.entry.js → p-d3ac9a1a.entry.js} +1 -1
  1315. package/dist/magma-components/{p-8740403e.system.entry.js → p-d4c3250f.system.entry.js} +2 -2
  1316. package/dist/magma-components/p-d638bbb0.entry.js +1 -0
  1317. package/dist/magma-components/{p-72ad419d.system.entry.js → p-d65e9f0a.system.entry.js} +1 -1
  1318. package/dist/magma-components/{p-358aa5e7.entry.js → p-d87ecd68.entry.js} +1 -1
  1319. package/dist/magma-components/{p-2e48f88d.system.entry.js → p-d93b48b4.system.entry.js} +1 -1
  1320. package/dist/magma-components/{p-9855b517.entry.js → p-d94281cb.entry.js} +1 -1
  1321. package/dist/magma-components/{p-55746791.entry.js → p-d9f92ff8.entry.js} +1 -1
  1322. package/dist/magma-components/{p-4cabfdbc.entry.js → p-da9bc02a.entry.js} +1 -1
  1323. package/dist/magma-components/{p-0148cf0a.entry.js → p-dc618cae.entry.js} +1 -1
  1324. package/dist/magma-components/p-de38f745.entry.js +1 -0
  1325. package/dist/magma-components/{p-0b3e4a97.system.entry.js → p-dee123c7.system.entry.js} +2 -2
  1326. package/dist/magma-components/p-df387755.entry.js +1 -0
  1327. package/dist/magma-components/p-dfab370b.entry.js +1 -0
  1328. package/dist/magma-components/{p-0e887379.system.entry.js → p-e30d0684.system.entry.js} +2 -2
  1329. package/dist/magma-components/{p-f66675f5.system.entry.js → p-e371f9e1.system.entry.js} +1 -1
  1330. package/dist/magma-components/{p-8f7daab1.system.entry.js → p-e3b9ea0b.system.entry.js} +1 -1
  1331. package/dist/magma-components/{p-104ba54e.system.entry.js → p-e3d262d9.system.entry.js} +2 -2
  1332. package/dist/magma-components/{p-7fde3025.system.entry.js → p-e54587e7.system.entry.js} +3 -3
  1333. package/dist/magma-components/{p-2cdf450c.system.entry.js → p-e5f893f9.system.entry.js} +2 -2
  1334. package/dist/magma-components/{p-d0a93a14.system.entry.js → p-e709a52e.system.entry.js} +6 -3
  1335. package/dist/magma-components/{p-8680f63e.entry.js → p-e8452cce.entry.js} +1 -1
  1336. package/dist/magma-components/{p-09f621ea.entry.js → p-ea503851.entry.js} +1 -1
  1337. package/dist/magma-components/{p-3dc81ab9.system.entry.js → p-ec44a4ea.system.entry.js} +4 -4
  1338. package/dist/magma-components/{p-8645533a.entry.js → p-ed133270.entry.js} +1 -1
  1339. package/dist/magma-components/{p-77939a25.system.entry.js → p-ee780f82.system.entry.js} +2 -2
  1340. package/dist/magma-components/p-ef4ee9ca.entry.js +1 -0
  1341. package/dist/magma-components/{p-15ffdcf6.entry.js → p-f045b018.entry.js} +1 -1
  1342. package/dist/magma-components/{p-87ce9d6c.entry.js → p-f2211b1f.entry.js} +1 -1
  1343. package/dist/magma-components/{p-2aac4003.entry.js → p-f267ff68.entry.js} +1 -1
  1344. package/dist/magma-components/{p-41a28f2a.system.entry.js → p-f27de6cb.system.entry.js} +3 -3
  1345. package/dist/magma-components/{p-1908f808.entry.js → p-f2ef884c.entry.js} +1 -1
  1346. package/dist/magma-components/{p-9f8ce68f.entry.js → p-f3f88f32.entry.js} +1 -1
  1347. package/dist/magma-components/{p-1eee93c8.system.entry.js → p-f40e3918.system.entry.js} +2 -2
  1348. package/dist/magma-components/{p-6e32bf99.entry.js → p-f4181b35.entry.js} +1 -1
  1349. package/dist/magma-components/{p-8a76097f.entry.js → p-f4351160.entry.js} +1 -1
  1350. package/dist/magma-components/{p-c3a3caae.system.entry.js → p-f4fc9f29.system.entry.js} +1 -1
  1351. package/dist/magma-components/{p-f2f992c2.system.entry.js → p-f5c7b147.system.entry.js} +2 -2
  1352. package/dist/magma-components/{p-84ed22ea.system.entry.js → p-f7d5445c.system.entry.js} +1 -1
  1353. package/dist/magma-components/{p-08370fc2.system.entry.js → p-f7e9af99.system.entry.js} +1 -1
  1354. package/dist/magma-components/{p-95478664.system.entry.js → p-f8c85ad7.system.entry.js} +1 -1
  1355. package/dist/magma-components/{p-c6819aad.entry.js → p-f9b601de.entry.js} +1 -1
  1356. package/dist/magma-components/{p-357724ab.entry.js → p-fa44d0d2.entry.js} +1 -1
  1357. package/dist/magma-components/{p-d3d74616.entry.js → p-fba648e0.entry.js} +1 -1
  1358. package/dist/magma-components/p-fe8e3721.system.entry.js +225 -0
  1359. package/dist/magma-components/{p-8d6470fb.system.entry.js → p-fe98a77e.system.entry.js} +2 -2
  1360. package/dist/magma-components/{p-d980c3d2.system.entry.js → p-ff7fc1f6.system.entry.js} +2 -2
  1361. package/dist/stats.json +3498 -1516
  1362. package/dist/types/common/locale.d.ts +5 -0
  1363. package/dist/types/components/mds-accordion/mds-accordion.d.ts +1 -0
  1364. package/dist/types/components/mds-accordion-item/mds-accordion-item.d.ts +1 -0
  1365. package/dist/types/components/mds-accordion-timer/mds-accordion-timer.d.ts +1 -0
  1366. package/dist/types/components/mds-accordion-timer-item/mds-accordion-timer-item.d.ts +1 -0
  1367. package/dist/types/components/mds-author/mds-author.d.ts +1 -0
  1368. package/dist/types/components/mds-avatar/mds-avatar.d.ts +1 -0
  1369. package/dist/types/components/mds-avatar-stack/mds-avatar-stack.d.ts +1 -0
  1370. package/dist/types/components/mds-avatar-stack-item/mds-avatar-stack-item.d.ts +3 -0
  1371. package/dist/types/components/mds-badge/mds-badge.d.ts +1 -0
  1372. package/dist/types/components/mds-banner/mds-banner.d.ts +1 -0
  1373. package/dist/types/components/mds-benchmark-bar/mds-benchmark-bar.d.ts +1 -0
  1374. package/dist/types/components/mds-bibliography/mds-bibliography.d.ts +3 -0
  1375. package/dist/types/components/mds-book/mds-book.d.ts +114 -0
  1376. package/dist/types/components/mds-book/meta/dictionary.d.ts +4 -0
  1377. package/dist/types/components/mds-book/meta/format.d.ts +30 -0
  1378. package/dist/types/components/mds-book/meta/pose.d.ts +64 -0
  1379. package/dist/types/components/mds-book/meta/spine.d.ts +33 -0
  1380. package/dist/types/components/mds-book/meta/types.d.ts +3 -0
  1381. package/dist/types/components/mds-book/meta/volume.d.ts +22 -0
  1382. package/dist/types/components/mds-breadcrumb/mds-breadcrumb.d.ts +1 -0
  1383. package/dist/types/components/mds-breadcrumb-item/mds-breadcrumb-item.d.ts +1 -0
  1384. package/dist/types/components/mds-button/mds-button.d.ts +1 -0
  1385. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +1 -0
  1386. package/dist/types/components/mds-button-group/mds-button-group.d.ts +1 -0
  1387. package/dist/types/components/mds-calendar/mds-calendar.d.ts +1 -0
  1388. package/dist/types/components/mds-calendar-cell/mds-calendar-cell.d.ts +3 -0
  1389. package/dist/types/components/mds-card/mds-card.d.ts +1 -0
  1390. package/dist/types/components/mds-card-content/mds-card-content.d.ts +1 -0
  1391. package/dist/types/components/mds-card-footer/mds-card-footer.d.ts +1 -0
  1392. package/dist/types/components/mds-card-header/mds-card-header.d.ts +1 -0
  1393. package/dist/types/components/mds-card-media/mds-card-media.d.ts +1 -0
  1394. package/dist/types/components/mds-chip/mds-chip.d.ts +3 -0
  1395. package/dist/types/components/mds-details/mds-details.d.ts +1 -0
  1396. package/dist/types/components/mds-dropdown/mds-dropdown.d.ts +1 -0
  1397. package/dist/types/components/mds-emoji/mds-emoji.d.ts +3 -0
  1398. package/dist/types/components/mds-entity/mds-entity.d.ts +1 -0
  1399. package/dist/types/components/mds-file/mds-file.d.ts +3 -0
  1400. package/dist/types/components/mds-file-preview/mds-file-preview.d.ts +1 -0
  1401. package/dist/types/components/mds-filter/mds-filter.d.ts +1 -0
  1402. package/dist/types/components/mds-filter-item/mds-filter-item.d.ts +3 -0
  1403. package/dist/types/components/mds-header/mds-header.d.ts +1 -0
  1404. package/dist/types/components/mds-header-bar/mds-header-bar.d.ts +1 -0
  1405. package/dist/types/components/mds-help/mds-help.d.ts +1 -0
  1406. package/dist/types/components/mds-horizontal-scroll/mds-horizontal-scroll.d.ts +1 -0
  1407. package/dist/types/components/mds-hr/mds-hr.d.ts +3 -0
  1408. package/dist/types/components/mds-icon/mds-icon.d.ts +1 -0
  1409. package/dist/types/components/mds-img/mds-img.d.ts +1 -0
  1410. package/dist/types/components/mds-input/mds-input.d.ts +1 -0
  1411. package/dist/types/components/mds-input/meta/validators.d.ts +7 -2
  1412. package/dist/types/components/mds-input/meta/validity.d.ts +3 -2
  1413. package/dist/types/components/mds-input-date/mds-input-date.d.ts +1 -0
  1414. package/dist/types/components/mds-input-date-range/mds-input-date-range.d.ts +1 -0
  1415. package/dist/types/components/mds-input-date-range-preselection/mds-input-date-range-preselection.d.ts +1 -0
  1416. package/dist/types/components/mds-input-field/mds-input-field.d.ts +1 -0
  1417. package/dist/types/components/mds-input-otp/mds-input-otp.d.ts +3 -0
  1418. package/dist/types/components/mds-input-range/mds-input-range.d.ts +1 -0
  1419. package/dist/types/components/mds-input-select/mds-input-select.d.ts +3 -1
  1420. package/dist/types/components/mds-input-switch/mds-input-switch.d.ts +1 -0
  1421. package/dist/types/components/mds-input-tip/mds-input-tip.d.ts +1 -0
  1422. package/dist/types/components/mds-input-tip-item/mds-input-tip-item.d.ts +1 -0
  1423. package/dist/types/components/mds-input-upload/mds-input-upload.d.ts +3 -0
  1424. package/dist/types/components/mds-keyboard/mds-keyboard.d.ts +1 -0
  1425. package/dist/types/components/mds-keyboard-key/mds-keyboard-key.d.ts +3 -0
  1426. package/dist/types/components/mds-kpi/mds-kpi.d.ts +1 -0
  1427. package/dist/types/components/mds-kpi-item/mds-kpi-item.d.ts +1 -0
  1428. package/dist/types/components/mds-label/mds-label.d.ts +3 -0
  1429. package/dist/types/components/mds-link/mds-link.d.ts +1 -0
  1430. package/dist/types/components/mds-list/mds-list.d.ts +1 -0
  1431. package/dist/types/components/mds-list-item/mds-list-item.d.ts +1 -0
  1432. package/dist/types/components/mds-mention/mds-mention.d.ts +3 -0
  1433. package/dist/types/components/mds-modal/mds-modal.d.ts +1 -0
  1434. package/dist/types/components/mds-note/mds-note.d.ts +1 -0
  1435. package/dist/types/components/mds-notification/mds-notification.d.ts +3 -0
  1436. package/dist/types/components/mds-paginator/mds-paginator.d.ts +3 -0
  1437. package/dist/types/components/mds-paginator-item/mds-paginator-item.d.ts +1 -0
  1438. package/dist/types/components/mds-policy-ai/mds-policy-ai.d.ts +1 -0
  1439. package/dist/types/components/mds-pref/mds-pref.d.ts +1 -1
  1440. package/dist/types/components/mds-pref-animation/mds-pref-animation.d.ts +3 -0
  1441. package/dist/types/components/mds-pref-consumption/mds-pref-consumption.d.ts +3 -0
  1442. package/dist/types/components/mds-pref-contrast/mds-pref-contrast.d.ts +3 -0
  1443. package/dist/types/components/mds-pref-language/mds-pref-language.d.ts +1 -0
  1444. package/dist/types/components/mds-pref-language-item/mds-pref-language-item.d.ts +3 -0
  1445. package/dist/types/components/mds-pref-mode/mds-pref-mode.d.ts +3 -0
  1446. package/dist/types/components/mds-pref-theme/mds-pref-theme.d.ts +1 -0
  1447. package/dist/types/components/mds-pref-theme-item/mds-pref-theme-item.d.ts +3 -0
  1448. package/dist/types/components/mds-price-table/mds-price-table.d.ts +1 -0
  1449. package/dist/types/components/mds-price-table-features/mds-price-table-features.d.ts +1 -0
  1450. package/dist/types/components/mds-price-table-features-cell/mds-price-table-features-cell.d.ts +1 -0
  1451. package/dist/types/components/mds-price-table-features-row/mds-price-table-features-row.d.ts +1 -0
  1452. package/dist/types/components/mds-price-table-header/mds-price-table-header.d.ts +1 -0
  1453. package/dist/types/components/mds-price-table-list/mds-price-table-list.d.ts +1 -0
  1454. package/dist/types/components/mds-price-table-list-item/mds-price-table-list-item.d.ts +1 -0
  1455. package/dist/types/components/mds-progress/mds-progress.d.ts +1 -0
  1456. package/dist/types/components/mds-push-notification/mds-push-notification.d.ts +1 -0
  1457. package/dist/types/components/mds-push-notification-item/mds-push-notification-item.d.ts +1 -0
  1458. package/dist/types/components/mds-quote/mds-quote.d.ts +1 -0
  1459. package/dist/types/components/mds-radial-menu/mds-radial-menu.d.ts +1 -0
  1460. package/dist/types/components/mds-radial-menu-item/mds-radial-menu-item.d.ts +3 -0
  1461. package/dist/types/components/mds-radial-progress/mds-radial-progress.d.ts +1 -0
  1462. package/dist/types/components/mds-separator/mds-separator.d.ts +3 -0
  1463. package/dist/types/components/mds-spinner/mds-spinner.d.ts +3 -0
  1464. package/dist/types/components/mds-status-bar/mds-status-bar.d.ts +1 -0
  1465. package/dist/types/components/mds-stepper-bar/mds-stepper-bar.d.ts +1 -0
  1466. package/dist/types/components/mds-stepper-bar-item/mds-stepper-bar-item.d.ts +1 -0
  1467. package/dist/types/components/mds-tab/mds-tab.d.ts +1 -0
  1468. package/dist/types/components/mds-tab-bar/mds-tab-bar.d.ts +1 -0
  1469. package/dist/types/components/mds-tab-bar-item/mds-tab-bar-item.d.ts +1 -0
  1470. package/dist/types/components/mds-tab-item/mds-tab-item.d.ts +1 -0
  1471. package/dist/types/components/mds-table/mds-table.d.ts +1 -0
  1472. package/dist/types/components/mds-table-body/mds-table-body.d.ts +1 -0
  1473. package/dist/types/components/mds-table-cell/mds-table-cell.d.ts +1 -0
  1474. package/dist/types/components/mds-table-footer/mds-table-footer.d.ts +1 -0
  1475. package/dist/types/components/mds-table-header/mds-table-header.d.ts +1 -0
  1476. package/dist/types/components/mds-table-header-cell/mds-table-header-cell.d.ts +1 -0
  1477. package/dist/types/components/mds-table-row/mds-table-row.d.ts +1 -0
  1478. package/dist/types/components/mds-text/mds-text.d.ts +1 -0
  1479. package/dist/types/components/mds-toast/mds-toast.d.ts +1 -0
  1480. package/dist/types/components/mds-toast-region/mds-toast-region.d.ts +1 -0
  1481. package/dist/types/components/mds-tooltip/mds-tooltip.d.ts +1 -0
  1482. package/dist/types/components/mds-tree/mds-tree.d.ts +1 -0
  1483. package/dist/types/components/mds-tree-item/mds-tree-item.d.ts +1 -0
  1484. package/dist/types/components/mds-url-view/mds-url-view.d.ts +3 -0
  1485. package/dist/types/components/mds-usage/mds-usage.d.ts +1 -0
  1486. package/dist/types/components/mds-video-wall/mds-video-wall.d.ts +1 -0
  1487. package/dist/types/components/mds-zero/mds-zero.d.ts +1 -0
  1488. package/dist/types/components.d.ts +1517 -6
  1489. package/package.json +42 -5
  1490. package/dist/components/p-B0AnE3sA.js +0 -1
  1491. package/dist/components/p-BbTcXgbr.js +0 -1
  1492. package/dist/components/p-CHHEp_7y.js +0 -1
  1493. package/dist/components/p-D8wd-EZX.js +0 -1
  1494. package/dist/magma-components/p-083dceb8.system.entry.js +0 -1
  1495. package/dist/magma-components/p-0eb3558a.entry.js +0 -1
  1496. package/dist/magma-components/p-2a964578.entry.js +0 -1
  1497. package/dist/magma-components/p-335244bb.entry.js +0 -1
  1498. package/dist/magma-components/p-3fb46ab9.system.entry.js +0 -1
  1499. package/dist/magma-components/p-4d485e1f.system.entry.js +0 -1
  1500. package/dist/magma-components/p-57839384.system.entry.js +0 -17
  1501. package/dist/magma-components/p-632ad925.system.entry.js +0 -222
  1502. package/dist/magma-components/p-6436178a.entry.js +0 -1
  1503. package/dist/magma-components/p-644e64a0.entry.js +0 -1
  1504. package/dist/magma-components/p-791a6a6f.entry.js +0 -1
  1505. package/dist/magma-components/p-7ec1ea2e.entry.js +0 -1
  1506. package/dist/magma-components/p-89d4b6e9.entry.js +0 -1
  1507. package/dist/magma-components/p-984dd850.entry.js +0 -1
  1508. package/dist/magma-components/p-a7c01334.entry.js +0 -1
  1509. package/dist/magma-components/p-a8e1ce2f.entry.js +0 -1
  1510. package/dist/magma-components/p-ab4b617d.entry.js +0 -1
  1511. package/dist/magma-components/p-d6b38d8a.entry.js +0 -1
  1512. package/dist/magma-components/p-da24a265.entry.js +0 -1
  1513. package/dist/magma-components/p-e1383302.entry.js +0 -1
  1514. package/dist/magma-components/p-f1aafe07.entry.js +0 -1
  1515. package/dist/magma-components/p-f78c1699.entry.js +0 -1
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input
8
8
 
9
- > `@maggioli-design-system/magma` 2.5.0. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.6.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
 
@@ -15,8 +15,10 @@ The `<mds-input>` web component is the primary single- and multi-line text entry
15
15
  - **Form association**: The component reports its value to the surrounding `<form>`, so it submits natively. On `disabled` the reported value is cleared. A form reset brings back the value the field had at load, both shown and submitted, and drops the `'success'` or `'error'` look of a past blur, like a native input.
16
16
  - **Disabled fieldset**: A disabled `<fieldset>` around the component disables it as `disabled` does, like a native control: it cannot be changed and its value is left out of the form, until the fieldset is enabled.
17
17
  - **Form validity**: The validators below also decide the validity reported to the form, on every change of the value or of the rules: like a native control, an invalid field matches `:invalid` and stops the submit, the browser shows a message in the page language next to the field and focuses it, and the field switches to `'error'` as on blur. Disabled and read-only fields are left out, and `novalidate` on the `<form>` turns the check off. `type="email"` and `type="url"` check the format of the value as a native input does.
18
- - **Validation on blur**: Validation runs when the field loses focus (and re-runs on input once invalid). It drives the `variant` automatically to `'success'` or `'error'`, emits `mdsInputValidation` with the boolean result, and reverts to `'primary'` when an optional field is emptied.
18
+ - **Validation on blur**: Validation runs when the field loses focus (and re-runs on input once invalid). A `required` field waits for that first blur too: until then, typing only updates its required tip. It drives the `variant` automatically to `'success'` or `'error'`, emits `mdsInputValidation` with the boolean result, and reverts to `'primary'` when an optional field is emptied.
19
19
  - **Type-aware validators**: The active validator set is derived from `type` - `email` and `url` install the format validators of the native types, `cf` the codice fiscale format and length validators, `isbn` a checksum validator, `piva` the partita IVA one (11 digits, the last one the check digit) and `cc` the card number one (13 to 19 digits, in groups split by spaces or dashes, that pass the Luhn check); no type applies an input mask, while `required`, `min`/`max` (any number, `0` included), `minlength`/`maxlength` and `pattern` add the corresponding constraint validators. As on a native input, `pattern` has to match the whole value, an expression that does not compile sets no rule, and `number`, `date`, `time` and `textarea` ignore it. The set is rebuilt whenever one of these props changes, also after load, as with the React wrappers under SSR: a pristine field only updates its required tip, a field already validated on blur is validated again. Custom validators can be attached at runtime through the `addValidator`/`removeValidator`/`hasValidator`/`getErrors` methods.
20
+ - **Localized messages**: The messages of the built-in validators, the ones `getErrors()` returns and `mds-input-field` shows, are in the language of the page when the value is validated (`el`, `en`, `es`, `it`, English for any other).
21
+ - **Error keys**: `getErrors()` reports each failed rule under its own key: `required`, `max`, `min`, `maxlength`, `minlength`, `pattern`, `email`, `url`, `piva`, `cc`, `isbn-error`, `cf-regex` and `cf-length`, plus the keys the custom validators return. Up to 2.5.0, `maxlength` and `minlength` were both reported as `minLenght`.
20
22
  - **Disabled / read-only tips**: `disabled` and `readonly` surface a persistent top tip describing the state; read-only fields also auto-select their text on focus.
21
23
  - **Character counter**: When `maxlength` is set a bottom counter tip shows `current / max` and shifts through fullness variants as the value approaches the limit. A `maxlength` of `0` or less is treated as unset.
22
24
  - **Password masking**: With `type="password"` a toggle button reveals/hides the value; it is disabled with the field.
@@ -118,22 +120,16 @@ The shared `variant` ladder (color role) is defined in [`agents/variants.md`](..
118
120
  | Property | Description |
119
121
  | --- | --- |
120
122
  | `--mds-input-background` | The background color of the input field. |
121
- | `--mds-input-icon-color` | The color of the icons inside the input. |
122
- | `--mds-input-placeholder-default-color` | The placeholder color in the default state. |
123
- | `--mds-input-placeholder-focus-color` | The placeholder color when the input is focused. |
124
- | `--mds-input-placeholder-hover-color` | The placeholder color when the input is hovered. |
125
123
  | `--mds-input-ring` | The outline ring applied to the input on interactive states. |
126
124
  | `--mds-input-shadow` | The box-shadow applied to the input component. |
127
- | `--mds-input-textarea-field-sizing` | The field-sizing behavior of the textarea. |
128
125
  | `--mds-input-textarea-max-height` | The max-height applied to the textarea. |
129
126
  | `--mds-input-textarea-min-height` | The min-height applied to the textarea. |
130
127
  | `--mds-input-textarea-resize` | Controls whether the textarea is resizable. |
131
128
  | `--mds-input-tip-background` | The background color of the input tip/inline help. |
132
- | `--mds-input-tip-horizontal-offset` | The default horizontal offset applied to the input tip |
133
- | `--mds-input-tip-horizontal-offset-focused` | The horizontal offset applied when the input tip is focused |
134
- | `--mds-input-tip-vertical-offset` | The vertical offset applied to the input tip |
135
129
  | `--mds-input-variant-color-rgb` | The raw RGB channels used for variant-driven styling. |
136
130
 
131
+ Only these are public. Its other 8 are internal: they may change in any release, do not set them.
132
+
137
133
  ## Dependencies
138
134
 
139
135
  Uses: `mds-button`, `mds-input-tip`, `mds-input-tip-item`, `mds-icon`, `mds-spinner`.
@@ -109,7 +109,7 @@ The component renders its own increment/decrement buttons and hides the native b
109
109
 
110
110
  #### Do Not Pierce the Shadow DOM to Style Internal Parts
111
111
 
112
- The supported customization surface is `--mds-input-*` CSS custom properties plus the documented shadow parts (`field`, `tip-top`, `tip-bottom`, `tip-count`, `password-toggle-button`, `counter-button-increase`, `counter-button-decrease`, `mic-toggle-button`). Targeting undocumented internals via `>>>` or arbitrary class names couples your code to the Shadow DOM implementation.
112
+ The supported customization surface is the public `--mds-input-*` CSS custom properties plus the documented shadow parts (`field`, `tip-top`, `tip-bottom`, `tip-count`, `password-toggle-button`, `counter-button-increase`, `counter-button-decrease`, `mic-toggle-button`). Targeting undocumented internals via `>>>` or arbitrary class names couples your code to the Shadow DOM implementation.
113
113
 
114
114
  ```css
115
115
  /* INCORRECT */
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-21T16:53:07",
2
+ "timestamp": "2026-10-24T12:14:05",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -51,12 +51,16 @@
51
51
  {
52
52
  "name": "part",
53
53
  "text": "tip-bottom - Selects the verbose status of input on bottom of element"
54
+ },
55
+ {
56
+ "name": "category",
57
+ "text": "forms"
54
58
  }
55
59
  ],
56
60
  "usage": {
57
- "1. Description": "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.\n\n#### Semantic Behavior\n\n- **Form association**: The component reports its value to the surrounding `<form>`, so it submits natively. On `disabled` the reported value is cleared. A form reset brings back the value the field had at load, both shown and submitted, and drops the `'success'` or `'error'` look of a past blur, like a native input.\n- **Disabled fieldset**: A disabled `<fieldset>` around the component disables it as `disabled` does, like a native control: it cannot be changed and its value is left out of the form, until the fieldset is enabled.\n- **Form validity**: The validators below also decide the validity reported to the form, on every change of the value or of the rules: like a native control, an invalid field matches `:invalid` and stops the submit, the browser shows a message in the page language next to the field and focuses it, and the field switches to `'error'` as on blur. Disabled and read-only fields are left out, and `novalidate` on the `<form>` turns the check off. `type=\"email\"` and `type=\"url\"` check the format of the value as a native input does.\n- **Validation on blur**: Validation runs when the field loses focus (and re-runs on input once invalid). It drives the `variant` automatically to `'success'` or `'error'`, emits `mdsInputValidation` with the boolean result, and reverts to `'primary'` when an optional field is emptied.\n- **Type-aware validators**: The active validator set is derived from `type` - `email` and `url` install the format validators of the native types, `cf` the codice fiscale format and length validators, `isbn` a checksum validator, `piva` the partita IVA one (11 digits, the last one the check digit) and `cc` the card number one (13 to 19 digits, in groups split by spaces or dashes, that pass the Luhn check); no type applies an input mask, while `required`, `min`/`max` (any number, `0` included), `minlength`/`maxlength` and `pattern` add the corresponding constraint validators. As on a native input, `pattern` has to match the whole value, an expression that does not compile sets no rule, and `number`, `date`, `time` and `textarea` ignore it. The set is rebuilt whenever one of these props changes, also after load, as with the React wrappers under SSR: a pristine field only updates its required tip, a field already validated on blur is validated again. Custom validators can be attached at runtime through the `addValidator`/`removeValidator`/`hasValidator`/`getErrors` methods.\n- **Disabled / read-only tips**: `disabled` and `readonly` surface a persistent top tip describing the state; read-only fields also auto-select their text on focus.\n- **Character counter**: When `maxlength` is set a bottom counter tip shows `current / max` and shifts through fullness variants as the value approaches the limit. A `maxlength` of `0` or less is treated as unset.\n- **Password masking**: With `type=\"password\"` a toggle button reveals/hides the value; it is disabled with the field.\n- **Number steppers**: With `type=\"number\"` increment/decrement buttons are rendered; their placement follows `controlsLayout` and their glyphs follow `controlsIcon`. They are disabled on a disabled or read-only field, like the spin buttons of a native one.\n- **Speech-to-text**: When `mic` is set a dictation button transcribes speech into the value, replacing what was there, and emits `mdsInputSpeechEnd` when the user stops the dictation; when the Web Speech API is unavailable the button switches to an error state and the value is left as it is. The dictation button is disabled on a disabled or read-only field, which the user cannot change, and a dictation in progress stops, emitting `mdsInputSpeechEnd`, when the field becomes so.\n- **Emitted events**: `mdsInputChange` carries the new value, `mdsInputKeydown` fires on every key pressed in the field with the native `KeyboardEvent` as detail (before the value changes: read the value from `mdsInputChange`), and `mdsInputFocus`/`mdsInputBlur` fire on focus transitions.\n\n#### Properties & Visual Configurations\n\nThe shared `variant` ladder (color role) is defined in [`agents/variants.md`](../../../../agents/variants.md); `<mds-input>` consumes it for both intent styling and validation feedback, but does not expose a `tone` prop. It accepts `primary` (default), `ai`, `info`, `success`, `warning` and `error`.\n\n- **`type`** selects both the rendered control and the validation profile: it covers the native HTML types plus format types (`'cf'`, `'piva'`, `'isbn'`, `'cc'`) and switches the host to a multi-line `<textarea>` for `'textarea'`.\n- **`variant=\"ai\"`** auto-assigns the AI chatbot icon when no `icon` is otherwise provided, signposting AI-assisted fields.\n- **`size`** sets the height of the field, the same as [`<mds-button>`](../mds-button/AGENTS.md): `sm` 28px, `md` 36px, `lg` 48px (default). Match it to the buttons next to the field, or go smaller in dense layouts (filter bars, table toolbars); the text style stays the same, the padding and the inner icon, stepper buttons and password and microphone toggles scale with it. A `textarea` keeps its own height (`--mds-input-textarea-min-height`).\n\n#### Other behavioral props\n\n- **`icon`** is an SVG filename slug from the Magma icon library shown at the leading (left) edge of the field; it is suppressed while `await` is active, since the spinner takes its place.\n- **`controlsLayout`** chooses between stacked (`'vertical'`) and split (`'horizontal'`) stepper buttons, and **`controlsIcon`** picks arrow vs. plus/minus glyphs - both apply only to `type=\"number\"`.\n- **`datalist`** supplies suggestion options for `type=\"search\"` style autocompletion.\n- **`tip`** renders inline helper text below the field, and **`typography`** selects the field's text scale.\n",
58
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-input>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Text Input\n\nThe simplest form: set `name` for form participation and `placeholder` for a visual hint. Wrap the component in [`mds-input-field`](../mds-input-field/AGENTS.md) to add a visible label and associated tip.\n\n```html\n<mds-input\n name=\"cognome\"\n placeholder=\"Inserisci il tuo cognome\"\n></mds-input>\n```\n\n#### Required Field with `tip` Helper Text\n\nUse `required` to validate that the field is not empty and `tip` to explain the constraint. The component surfaces a top-tip when focused and drives `variant` to `'error'` or `'success'` on blur. When the field collects the user's own data, set the matching `autocomplete` token (`email`, `given-name`, `tel`, ...) so browsers can identify its purpose (WCAG 2.1 SC 1.3.5) and offer autofill; without it the component default `autocomplete=\"off\"` applies.\n\n```html\n<mds-input\n name=\"email\"\n type=\"email\"\n autocomplete=\"email\"\n placeholder=\"nome@esempio.it\"\n required\n tip=\"Inserisci un indirizzo email valido\"\n></mds-input>\n```\n\n#### Textarea for Multi-line Content\n\nSet `type=\"textarea\"` to render a `<textarea>` instead of a single-line `<input>`. Use the `--mds-input-textarea-*` custom properties to control height and resize behaviour.\n\n```html\n<mds-input\n name=\"descrizione\"\n type=\"textarea\"\n placeholder=\"Descrivi il problema...\"\n maxlength=\"500\"\n></mds-input>\n```\n\n#### Character Counter via `maxlength`\n\nWhen `maxlength` is set the component renders a live `current / max` counter below the field. The counter shifts through fullness variants as the limit approaches. A value of `0` or less is treated as unset.\n\n```html\n<mds-input\n name=\"titolo\"\n placeholder=\"Titolo dell'articolo\"\n maxlength=\"120\"\n></mds-input>\n```\n\n#### Numeric Input with Steppers\n\nSet `type=\"number\"` to enable built-in increment/decrement buttons. Use `controlsLayout` to choose between stacked (`'vertical'`, default) and split (`'horizontal'`) placement, and `controlsIcon` to pick arrow vs. plus/minus glyphs. Use `min`, `max`, and `step` to constrain the legal range.\n\n```html\n<!-- Stacked (default) - arrow glyphs -->\n<mds-input\n name=\"quantita\"\n type=\"number\"\n min=\"1\"\n max=\"99\"\n step=\"1\"\n placeholder=\"1\"\n></mds-input>\n\n<!-- Horizontal split - arithmetic glyphs -->\n<mds-input\n name=\"quantita\"\n type=\"number\"\n min=\"0\"\n max=\"100\"\n controls-layout=\"horizontal\"\n controls-icon=\"arithmetic\"\n placeholder=\"0\"\n></mds-input>\n```\n\n#### Password Input\n\nSet `type=\"password\"` to render a masked field with a built-in visibility toggle. The component renders a custom dot-mask overlay and a show/hide button - no extra wiring is needed. Always set `autocomplete` to `new-password` (sign-up, password change) or `current-password` (login): the component default is `autocomplete=\"off\"`, which browsers and password managers ignore on credential fields, but the explicit token is what lets them pair the password with its username field and fill or generate the right value.\n\n```html\n<mds-input\n name=\"password\"\n type=\"password\"\n autocomplete=\"new-password\"\n placeholder=\"Scegli una password\"\n required\n></mds-input>\n```\n\n#### Login Form\n\nPair a username field carrying `autocomplete=\"username\"` with a password field carrying `autocomplete=\"current-password\"` inside a `<form>`, and submit through `<mds-button type=\"submit\">`. The native fields live in the Shadow DOM of each `<mds-input>`: among the password managers tested, Bitwarden, LastPass, Chrome and Edge detect and fill them, Firefox's built-in manager and KeePassXC-Browser do not (they only look at the light DOM).\n\n```html\n<form action=\"/login\" method=\"post\">\n <mds-input-field label=\"Email\">\n <mds-input name=\"username\" type=\"email\" autocomplete=\"username\" required></mds-input>\n </mds-input-field>\n <mds-input-field label=\"Password\">\n <mds-input name=\"password\" type=\"password\" autocomplete=\"current-password\" required></mds-input>\n </mds-input-field>\n\n <mds-button type=\"submit\" label=\"Accedi\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Italian-Specific Masked Types\n\n`type=\"cf\"` installs the codice fiscale format and length validators and `type=\"isbn\"` a checksum validator. `type=\"piva\"` accepts 11 digits whose last one is the check digit, without the `IT` prefix or spaces, and `type=\"cc\"` 13 to 19 digits, in groups split by spaces or dashes, that pass the Luhn check of card numbers. A value that breaks the format stops the submit of the form. No type applies a keyboard mask.\n\n```html\n<mds-input name=\"codice_fiscale\" type=\"cf\" placeholder=\"RSSMRA80A01H501Z\"></mds-input>\n<mds-input name=\"partita_iva\" type=\"piva\" placeholder=\"01234567890\"></mds-input>\n```\n\n#### Search Input with Datalist\n\nUse `type=\"search\"` combined with the `datalist` prop to offer autocomplete suggestions from a fixed list. The list is rendered inside the shadow DOM and wired automatically.\n\n```html\n<mds-input\n name=\"comune\"\n type=\"search\"\n placeholder=\"Cerca comune...\"\n></mds-input>\n```\n\n```javascript\n// Pass suggestions as a JavaScript array\ndocument.querySelector('mds-input').datalist = ['Roma', 'Milano', 'Napoli', 'Torino'];\n```\n\n#### Icon Decoration\n\nThe `icon` prop renders an SVG slug from the Magma icon library at the leading edge of the field. The icon is suppressed while `await` is active and the spinner takes its place.\n\n```html\n<mds-input\n name=\"cerca\"\n type=\"search\"\n icon=\"mi/baseline/search\"\n placeholder=\"Cerca...\"\n></mds-input>\n```\n\n#### AI-Assisted Field\n\nSet `variant=\"ai\"` to signal an AI-powered field. When no `icon` prop is present, the component auto-assigns the AI chatbot icon.\n\n```html\n<mds-input\n name=\"prompt\"\n type=\"text\"\n variant=\"ai\"\n placeholder=\"Chiedi qualcosa all'assistente...\"\n></mds-input>\n```\n\n#### Async Loading via `await`\n\nSet the `await` boolean attribute while an async operation (e.g. a lookup) is in flight. The component renders an inline spinner in place of the icon. Remove the attribute when done - do not set `await=\"false\"`.\n\n```html\n<mds-input name=\"codice\" placeholder=\"Verifica in corso...\" await></mds-input>\n```\n\n#### Speech-to-Text Dictation\n\nSet the `mic` boolean attribute to render a dictation button. Starting a dictation clears the current value and writes the recognized speech in its place; the component emits `mdsInputSpeechEnd` when the user stops the dictation. If the Web Speech API is unavailable the button switches to an error state and the value is kept.\n\n```html\n<mds-input\n name=\"note_vocali\"\n type=\"text\"\n mic\n placeholder=\"Parla o scrivi...\"\n></mds-input>\n```\n\n#### Listening to Events\n\nListen for `mdsInputChange` instead of native `input` or `change`: `change` does not cross the shadow boundary, and `input` reports only typing, not the values set by the steppers, the dictation or a script.\n\n```javascript\ndocument.querySelector('mds-input').addEventListener('mdsInputChange', (e) => {\n console.log(e.detail.value);\n});\n\ndocument.querySelector('mds-input').addEventListener('mdsInputValidation', (e) => {\n console.log('valido:', e.detail);\n});\n```\n\n#### Form Participation\n\n`<mds-input>` is form-associated. It submits natively inside a `<form>`; set `name` so the value is included in form data. Its validation is reported to the form too: an empty `required` field, or one that breaks another rule, stops the submit like a native input and shows the error. Add `novalidate` to the `<form>` when your own code validates on submit. A reset brings every field back to its value at load and to its pristine look.\n\n```html\n<form action=\"/salva\" method=\"post\">\n <mds-input name=\"nome\" type=\"text\" placeholder=\"Nome\" required></mds-input>\n <mds-input name=\"cognome\" type=\"text\" placeholder=\"Cognome\" required></mds-input>\n <mds-input name=\"email\" type=\"email\" placeholder=\"Email\" required></mds-input>\n\n <mds-button type=\"submit\" label=\"Invia\" variant=\"primary\" tone=\"strong\"></mds-button>\n <mds-button type=\"reset\" label=\"Annulla\" variant=\"dark\" tone=\"outline\"></mds-button>\n</form>\n```\n\n#### Read-Only Display\n\nUse `readonly` when the value should be visible but not editable. A persistent top tip describes the state, and the field text is auto-selected on focus for easy copying.\n\n```html\n<mds-input\n name=\"codice_riferimento\"\n value=\"REF-2024-00123\"\n readonly\n></mds-input>\n```\n\n#### Styling Customization\n\nStyle the input only through its documented `--mds-input-*` CSS custom properties. Set them on the host or a parent selector. Use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.search-bar mds-input {\n --mds-input-background: rgb(var(--magma-wash-base));\n --mds-input-placeholder-default-color: rgb(var(--magma-text-disabled));\n --mds-input-icon-color: rgb(var(--magma-accent-fg));\n}\n\n/* Textarea: fixed height, allow resize */\n.notes-area mds-input {\n --mds-input-textarea-min-height: 8rem;\n --mds-input-textarea-max-height: 24rem;\n --mds-input-textarea-resize: vertical;\n}\n```\n\n#### Sizing a Field to the Controls Next to It\n\nGive the fields of a row the `size` of the buttons beside them, so they share one height: `sm` 28px, `md` 36px, `lg` 48px (default), the sizes of [`<mds-button>`](../mds-button/AGENTS.md). `<mds-input-select>`, `<mds-input-date>` and `<mds-input-date-range>` take the same values.\n\n```html\n<div class=\"flex items-center gap-200\">\n <mds-input size=\"md\" type=\"search\" icon=\"mi/baseline/search\" placeholder=\"Cerca\"></mds-input>\n <mds-input-select size=\"md\" placeholder=\"Stato\">\n <option value=\"open\">Aperte</option>\n <option value=\"closed\">Chiuse</option>\n </mds-input-select>\n <mds-button size=\"md\" label=\"Filtra\"></mds-button>\n</div>\n```\n\n",
59
- "3. Antipattern": "Common incorrect uses of `<mds-input>`. 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 a Raw `<input>` When `<mds-input>` Exists\n\nReaching for a plain `<input>` bypasses theming, validation, tips, accessible state announcements, and form-reset behavior provided by the component.\n\n```html\n<!-- INCORRECT -->\n<input type=\"text\" name=\"nome\" placeholder=\"Nome\" class=\"my-input\">\n\n<!-- CORRECT -->\n<mds-input name=\"nome\" type=\"text\" placeholder=\"Nome\"></mds-input>\n```\n\n#### Do Not Set Boolean Attributes to the String `\"false\"`\n\n`disabled`, `required`, `readonly`, `mic` and `await` are boolean attributes: remove the attribute entirely to turn it off. `mds-input` is form-associated, so as on a native control any value turns them on, `\"false\"` included: this markup renders a disabled, required field.\n\n```html\n<!-- INCORRECT -->\n<mds-input name=\"note\" disabled=\"false\" required=\"false\"></mds-input>\n\n<!-- CORRECT -->\n<mds-input name=\"note\"></mds-input>\n```\n\n#### Do Not Force `variant` for Validation Feedback\n\nThe component drives `variant` to `'success'` or `'error'` automatically on blur when validators are active. Setting `variant` manually overrides the feedback and breaks the visual contract.\n\n```html\n<!-- INCORRECT -->\n<mds-input name=\"codice\" variant=\"error\" tip=\"Valore non valido\"></mds-input>\n\n<!-- CORRECT -->\n<mds-input name=\"codice\" required tip=\"Inserisci un valore valido\"></mds-input>\n```\n\n#### Do Not Listen to Native `input` or `change` Events\n\nThe native `change` event does not cross the shadow boundary, and `input` reports only typing, not the values set by the steppers, the dictation or a script. Use the documented `mdsInputChange` event instead, which fires for every value change.\n\n```javascript\n// INCORRECT\ndocument.querySelector('mds-input').addEventListener('input', (e) => {\n console.log(e.target.value);\n});\n\n// CORRECT\ndocument.querySelector('mds-input').addEventListener('mdsInputChange', (e) => {\n console.log(e.detail.value);\n});\n```\n\n#### Do Not Use `type=\"number\"` Native Browser Spinners and Then Override the Input\n\nThe component renders its own increment/decrement buttons and hides the native browser spinners. Do not try to re-enable them via CSS, and do not add inline JS `stepUp`/`stepDown` calls - use the `controlsLayout` and `controlsIcon` props to configure the built-in controls.\n\n```html\n<!-- INCORRECT -->\n<mds-input type=\"number\" style=\"-moz-appearance: auto;\"></mds-input>\n\n<!-- CORRECT -->\n<mds-input\n type=\"number\"\n controls-layout=\"horizontal\"\n controls-icon=\"arithmetic\"\n min=\"0\"\n max=\"100\"\n></mds-input>\n```\n\n#### Do Not Use a Legacy or Invalid `type` Value\n\n`<mds-input>` accepts a specific set of `type` values: `text`, `email`, `number`, `password`, `search`, `tel`, `url`, `date`, `time`, `textarea`, `cf`, `piva`, `cc`, `isbn`. Supplying anything else (e.g. `\"checkbox\"`, `\"radio\"`, `\"file\"`) is passed straight to the inner native `<input>`, which renders a bare native control that the component neither styles nor reports correctly to the form. Use the dedicated Magma component for those controls.\n\n```html\n<!-- INCORRECT -->\n<mds-input type=\"checkbox\" name=\"accetto\"></mds-input>\n<mds-input type=\"file\" name=\"allegato\"></mds-input>\n\n<!-- CORRECT -->\n<mds-input-switch name=\"accetto\"></mds-input-switch>\n<mds-input-upload name=\"allegato\"></mds-input-upload>\n```\n\n#### Do Not Use `placeholder` as the Accessible Label\n\n`placeholder` disappears on input and is never read as a label by assistive tech. Always pair `<mds-input>` with [`mds-input-field`](../mds-input-field/AGENTS.md) (which shows a visible label and passes it down as the accessible name) or supply `aria-label` directly on the host.\n\n```html\n<!-- INCORRECT -->\n<mds-input name=\"ricerca\" placeholder=\"Cerca per nome\"></mds-input>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Cerca per nome\">\n <mds-input name=\"ricerca\" placeholder=\"Cerca per nome\"></mds-input>\n</mds-input-field>\n```\n\n#### Do Not Pierce the Shadow DOM to Style Internal Parts\n\nThe supported customization surface is `--mds-input-*` CSS custom properties plus the documented shadow parts (`field`, `tip-top`, `tip-bottom`, `tip-count`, `password-toggle-button`, `counter-button-increase`, `counter-button-decrease`, `mic-toggle-button`). Targeting undocumented internals via `>>>` or arbitrary class names couples your code to the Shadow DOM implementation.\n\n```css\n/* INCORRECT */\nmds-input >>> .input {\n border: 2px solid red;\n}\n\n/* CORRECT */\nmds-input {\n --mds-input-ring: 0 0 0 2px rgb(var(--magma-danger-border));\n --mds-input-background: rgb(var(--magma-danger-wash-base));\n}\nmds-input::part(field) {\n font-style: italic;\n}\n```\n"
61
+ "1. Description": "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.\n\n#### Semantic Behavior\n\n- **Form association**: The component reports its value to the surrounding `<form>`, so it submits natively. On `disabled` the reported value is cleared. A form reset brings back the value the field had at load, both shown and submitted, and drops the `'success'` or `'error'` look of a past blur, like a native input.\n- **Disabled fieldset**: A disabled `<fieldset>` around the component disables it as `disabled` does, like a native control: it cannot be changed and its value is left out of the form, until the fieldset is enabled.\n- **Form validity**: The validators below also decide the validity reported to the form, on every change of the value or of the rules: like a native control, an invalid field matches `:invalid` and stops the submit, the browser shows a message in the page language next to the field and focuses it, and the field switches to `'error'` as on blur. Disabled and read-only fields are left out, and `novalidate` on the `<form>` turns the check off. `type=\"email\"` and `type=\"url\"` check the format of the value as a native input does.\n- **Validation on blur**: Validation runs when the field loses focus (and re-runs on input once invalid). A `required` field waits for that first blur too: until then, typing only updates its required tip. It drives the `variant` automatically to `'success'` or `'error'`, emits `mdsInputValidation` with the boolean result, and reverts to `'primary'` when an optional field is emptied.\n- **Type-aware validators**: The active validator set is derived from `type` - `email` and `url` install the format validators of the native types, `cf` the codice fiscale format and length validators, `isbn` a checksum validator, `piva` the partita IVA one (11 digits, the last one the check digit) and `cc` the card number one (13 to 19 digits, in groups split by spaces or dashes, that pass the Luhn check); no type applies an input mask, while `required`, `min`/`max` (any number, `0` included), `minlength`/`maxlength` and `pattern` add the corresponding constraint validators. As on a native input, `pattern` has to match the whole value, an expression that does not compile sets no rule, and `number`, `date`, `time` and `textarea` ignore it. The set is rebuilt whenever one of these props changes, also after load, as with the React wrappers under SSR: a pristine field only updates its required tip, a field already validated on blur is validated again. Custom validators can be attached at runtime through the `addValidator`/`removeValidator`/`hasValidator`/`getErrors` methods.\n- **Localized messages**: The messages of the built-in validators, the ones `getErrors()` returns and `mds-input-field` shows, are in the language of the page when the value is validated (`el`, `en`, `es`, `it`, English for any other).\n- **Error keys**: `getErrors()` reports each failed rule under its own key: `required`, `max`, `min`, `maxlength`, `minlength`, `pattern`, `email`, `url`, `piva`, `cc`, `isbn-error`, `cf-regex` and `cf-length`, plus the keys the custom validators return. Up to 2.5.0, `maxlength` and `minlength` were both reported as `minLenght`.\n- **Disabled / read-only tips**: `disabled` and `readonly` surface a persistent top tip describing the state; read-only fields also auto-select their text on focus.\n- **Character counter**: When `maxlength` is set a bottom counter tip shows `current / max` and shifts through fullness variants as the value approaches the limit. A `maxlength` of `0` or less is treated as unset.\n- **Password masking**: With `type=\"password\"` a toggle button reveals/hides the value; it is disabled with the field.\n- **Number steppers**: With `type=\"number\"` increment/decrement buttons are rendered; their placement follows `controlsLayout` and their glyphs follow `controlsIcon`. They are disabled on a disabled or read-only field, like the spin buttons of a native one.\n- **Speech-to-text**: When `mic` is set a dictation button transcribes speech into the value, replacing what was there, and emits `mdsInputSpeechEnd` when the user stops the dictation; when the Web Speech API is unavailable the button switches to an error state and the value is left as it is. The dictation button is disabled on a disabled or read-only field, which the user cannot change, and a dictation in progress stops, emitting `mdsInputSpeechEnd`, when the field becomes so.\n- **Emitted events**: `mdsInputChange` carries the new value, `mdsInputKeydown` fires on every key pressed in the field with the native `KeyboardEvent` as detail (before the value changes: read the value from `mdsInputChange`), and `mdsInputFocus`/`mdsInputBlur` fire on focus transitions.\n\n#### Properties & Visual Configurations\n\nThe shared `variant` ladder (color role) is defined in [`agents/variants.md`](../../../../agents/variants.md); `<mds-input>` consumes it for both intent styling and validation feedback, but does not expose a `tone` prop. It accepts `primary` (default), `ai`, `info`, `success`, `warning` and `error`.\n\n- **`type`** selects both the rendered control and the validation profile: it covers the native HTML types plus format types (`'cf'`, `'piva'`, `'isbn'`, `'cc'`) and switches the host to a multi-line `<textarea>` for `'textarea'`.\n- **`variant=\"ai\"`** auto-assigns the AI chatbot icon when no `icon` is otherwise provided, signposting AI-assisted fields.\n- **`size`** sets the height of the field, the same as [`<mds-button>`](../mds-button/AGENTS.md): `sm` 28px, `md` 36px, `lg` 48px (default). Match it to the buttons next to the field, or go smaller in dense layouts (filter bars, table toolbars); the text style stays the same, the padding and the inner icon, stepper buttons and password and microphone toggles scale with it. A `textarea` keeps its own height (`--mds-input-textarea-min-height`).\n\n#### Other behavioral props\n\n- **`icon`** is an SVG filename slug from the Magma icon library shown at the leading (left) edge of the field; it is suppressed while `await` is active, since the spinner takes its place.\n- **`controlsLayout`** chooses between stacked (`'vertical'`) and split (`'horizontal'`) stepper buttons, and **`controlsIcon`** picks arrow vs. plus/minus glyphs - both apply only to `type=\"number\"`.\n- **`datalist`** supplies suggestion options for `type=\"search\"` style autocompletion.\n- **`tip`** renders inline helper text below the field, and **`typography`** selects the field's text scale.\n",
62
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-input>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Text Input\n\nThe simplest form: set `name` for form participation and `placeholder` for a visual hint. Wrap the component in [`mds-input-field`](../mds-input-field/AGENTS.md) to add a visible label and associated tip.\n\n```html\n<mds-input\n name=\"cognome\"\n placeholder=\"Inserisci il tuo cognome\"\n></mds-input>\n```\n\n#### Required Field with `tip` Helper Text\n\nUse `required` to validate that the field is not empty and `tip` to explain the constraint. The component surfaces a top-tip when focused and drives `variant` to `'error'` or `'success'` on blur. When the field collects the user's own data, set the matching `autocomplete` token (`email`, `given-name`, `tel`, ...) so browsers can identify its purpose (WCAG 2.1 SC 1.3.5) and offer autofill; without it the component default `autocomplete=\"off\"` applies.\n\n```html\n<mds-input\n name=\"email\"\n type=\"email\"\n autocomplete=\"email\"\n placeholder=\"nome@esempio.it\"\n required\n tip=\"Inserisci un indirizzo email valido\"\n></mds-input>\n```\n\n#### Textarea for Multi-line Content\n\nSet `type=\"textarea\"` to render a `<textarea>` instead of a single-line `<input>`. Use the `--mds-input-textarea-*` custom properties to control height and resize behaviour.\n\n```html\n<mds-input\n name=\"descrizione\"\n type=\"textarea\"\n placeholder=\"Descrivi il problema...\"\n maxlength=\"500\"\n></mds-input>\n```\n\n#### Character Counter via `maxlength`\n\nWhen `maxlength` is set the component renders a live `current / max` counter below the field. The counter shifts through fullness variants as the limit approaches. A value of `0` or less is treated as unset.\n\n```html\n<mds-input\n name=\"titolo\"\n placeholder=\"Titolo dell'articolo\"\n maxlength=\"120\"\n></mds-input>\n```\n\n#### Numeric Input with Steppers\n\nSet `type=\"number\"` to enable built-in increment/decrement buttons. Use `controlsLayout` to choose between stacked (`'vertical'`, default) and split (`'horizontal'`) placement, and `controlsIcon` to pick arrow vs. plus/minus glyphs. Use `min`, `max`, and `step` to constrain the legal range.\n\n```html\n<!-- Stacked (default) - arrow glyphs -->\n<mds-input\n name=\"quantita\"\n type=\"number\"\n min=\"1\"\n max=\"99\"\n step=\"1\"\n placeholder=\"1\"\n></mds-input>\n\n<!-- Horizontal split - arithmetic glyphs -->\n<mds-input\n name=\"quantita\"\n type=\"number\"\n min=\"0\"\n max=\"100\"\n controls-layout=\"horizontal\"\n controls-icon=\"arithmetic\"\n placeholder=\"0\"\n></mds-input>\n```\n\n#### Password Input\n\nSet `type=\"password\"` to render a masked field with a built-in visibility toggle. The component renders a custom dot-mask overlay and a show/hide button - no extra wiring is needed. Always set `autocomplete` to `new-password` (sign-up, password change) or `current-password` (login): the component default is `autocomplete=\"off\"`, which browsers and password managers ignore on credential fields, but the explicit token is what lets them pair the password with its username field and fill or generate the right value.\n\n```html\n<mds-input\n name=\"password\"\n type=\"password\"\n autocomplete=\"new-password\"\n placeholder=\"Scegli una password\"\n required\n></mds-input>\n```\n\n#### Login Form\n\nPair a username field carrying `autocomplete=\"username\"` with a password field carrying `autocomplete=\"current-password\"` inside a `<form>`, and submit through `<mds-button type=\"submit\">`. The native fields live in the Shadow DOM of each `<mds-input>`: among the password managers tested, Bitwarden, LastPass, Chrome and Edge detect and fill them, Firefox's built-in manager and KeePassXC-Browser do not (they only look at the light DOM).\n\n```html\n<form action=\"/login\" method=\"post\">\n <mds-input-field label=\"Email\">\n <mds-input name=\"username\" type=\"email\" autocomplete=\"username\" required></mds-input>\n </mds-input-field>\n <mds-input-field label=\"Password\">\n <mds-input name=\"password\" type=\"password\" autocomplete=\"current-password\" required></mds-input>\n </mds-input-field>\n\n <mds-button type=\"submit\" label=\"Accedi\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Italian-Specific Masked Types\n\n`type=\"cf\"` installs the codice fiscale format and length validators and `type=\"isbn\"` a checksum validator. `type=\"piva\"` accepts 11 digits whose last one is the check digit, without the `IT` prefix or spaces, and `type=\"cc\"` 13 to 19 digits, in groups split by spaces or dashes, that pass the Luhn check of card numbers. A value that breaks the format stops the submit of the form. No type applies a keyboard mask.\n\n```html\n<mds-input name=\"codice_fiscale\" type=\"cf\" placeholder=\"RSSMRA80A01H501Z\"></mds-input>\n<mds-input name=\"partita_iva\" type=\"piva\" placeholder=\"01234567890\"></mds-input>\n```\n\n#### Search Input with Datalist\n\nUse `type=\"search\"` combined with the `datalist` prop to offer autocomplete suggestions from a fixed list. The list is rendered inside the shadow DOM and wired automatically.\n\n```html\n<mds-input\n name=\"comune\"\n type=\"search\"\n placeholder=\"Cerca comune...\"\n></mds-input>\n```\n\n```javascript\n// Pass suggestions as a JavaScript array\ndocument.querySelector('mds-input').datalist = ['Roma', 'Milano', 'Napoli', 'Torino'];\n```\n\n#### Icon Decoration\n\nThe `icon` prop renders an SVG slug from the Magma icon library at the leading edge of the field. The icon is suppressed while `await` is active and the spinner takes its place.\n\n```html\n<mds-input\n name=\"cerca\"\n type=\"search\"\n icon=\"mi/baseline/search\"\n placeholder=\"Cerca...\"\n></mds-input>\n```\n\n#### AI-Assisted Field\n\nSet `variant=\"ai\"` to signal an AI-powered field. When no `icon` prop is present, the component auto-assigns the AI chatbot icon.\n\n```html\n<mds-input\n name=\"prompt\"\n type=\"text\"\n variant=\"ai\"\n placeholder=\"Chiedi qualcosa all'assistente...\"\n></mds-input>\n```\n\n#### Async Loading via `await`\n\nSet the `await` boolean attribute while an async operation (e.g. a lookup) is in flight. The component renders an inline spinner in place of the icon. Remove the attribute when done - do not set `await=\"false\"`.\n\n```html\n<mds-input name=\"codice\" placeholder=\"Verifica in corso...\" await></mds-input>\n```\n\n#### Speech-to-Text Dictation\n\nSet the `mic` boolean attribute to render a dictation button. Starting a dictation clears the current value and writes the recognized speech in its place; the component emits `mdsInputSpeechEnd` when the user stops the dictation. If the Web Speech API is unavailable the button switches to an error state and the value is kept.\n\n```html\n<mds-input\n name=\"note_vocali\"\n type=\"text\"\n mic\n placeholder=\"Parla o scrivi...\"\n></mds-input>\n```\n\n#### Listening to Events\n\nListen for `mdsInputChange` instead of native `input` or `change`: `change` does not cross the shadow boundary, and `input` reports only typing, not the values set by the steppers, the dictation or a script.\n\n```javascript\ndocument.querySelector('mds-input').addEventListener('mdsInputChange', (e) => {\n console.log(e.detail.value);\n});\n\ndocument.querySelector('mds-input').addEventListener('mdsInputValidation', (e) => {\n console.log('valido:', e.detail);\n});\n```\n\n#### Form Participation\n\n`<mds-input>` is form-associated. It submits natively inside a `<form>`; set `name` so the value is included in form data. Its validation is reported to the form too: an empty `required` field, or one that breaks another rule, stops the submit like a native input and shows the error. Add `novalidate` to the `<form>` when your own code validates on submit. A reset brings every field back to its value at load and to its pristine look.\n\n```html\n<form action=\"/salva\" method=\"post\">\n <mds-input name=\"nome\" type=\"text\" placeholder=\"Nome\" required></mds-input>\n <mds-input name=\"cognome\" type=\"text\" placeholder=\"Cognome\" required></mds-input>\n <mds-input name=\"email\" type=\"email\" placeholder=\"Email\" required></mds-input>\n\n <mds-button type=\"submit\" label=\"Invia\" variant=\"primary\" tone=\"strong\"></mds-button>\n <mds-button type=\"reset\" label=\"Annulla\" variant=\"dark\" tone=\"outline\"></mds-button>\n</form>\n```\n\n#### Read-Only Display\n\nUse `readonly` when the value should be visible but not editable. A persistent top tip describes the state, and the field text is auto-selected on focus for easy copying.\n\n```html\n<mds-input\n name=\"codice_riferimento\"\n value=\"REF-2024-00123\"\n readonly\n></mds-input>\n```\n\n#### Styling Customization\n\nStyle the input only through its public `--mds-input-*` CSS custom properties. Set them on the host or a parent selector. Use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.search-bar mds-input {\n --mds-input-background: rgb(var(--magma-wash-base));\n}\n\n/* Textarea: fixed height, allow resize */\n.notes-area mds-input {\n --mds-input-textarea-min-height: 8rem;\n --mds-input-textarea-max-height: 24rem;\n --mds-input-textarea-resize: vertical;\n}\n```\n\n#### Sizing a Field to the Controls Next to It\n\nGive the fields of a row the `size` of the buttons beside them, so they share one height: `sm` 28px, `md` 36px, `lg` 48px (default), the sizes of [`<mds-button>`](../mds-button/AGENTS.md). `<mds-input-select>`, `<mds-input-date>` and `<mds-input-date-range>` take the same values.\n\n```html\n<div class=\"flex items-center gap-200\">\n <mds-input size=\"md\" type=\"search\" icon=\"mi/baseline/search\" placeholder=\"Cerca\"></mds-input>\n <mds-input-select size=\"md\" placeholder=\"Stato\">\n <option value=\"open\">Aperte</option>\n <option value=\"closed\">Chiuse</option>\n </mds-input-select>\n <mds-button size=\"md\" label=\"Filtra\"></mds-button>\n</div>\n```\n\n",
63
+ "3. Antipattern": "Common incorrect uses of `<mds-input>`. 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 a Raw `<input>` When `<mds-input>` Exists\n\nReaching for a plain `<input>` bypasses theming, validation, tips, accessible state announcements, and form-reset behavior provided by the component.\n\n```html\n<!-- INCORRECT -->\n<input type=\"text\" name=\"nome\" placeholder=\"Nome\" class=\"my-input\">\n\n<!-- CORRECT -->\n<mds-input name=\"nome\" type=\"text\" placeholder=\"Nome\"></mds-input>\n```\n\n#### Do Not Set Boolean Attributes to the String `\"false\"`\n\n`disabled`, `required`, `readonly`, `mic` and `await` are boolean attributes: remove the attribute entirely to turn it off. `mds-input` is form-associated, so as on a native control any value turns them on, `\"false\"` included: this markup renders a disabled, required field.\n\n```html\n<!-- INCORRECT -->\n<mds-input name=\"note\" disabled=\"false\" required=\"false\"></mds-input>\n\n<!-- CORRECT -->\n<mds-input name=\"note\"></mds-input>\n```\n\n#### Do Not Force `variant` for Validation Feedback\n\nThe component drives `variant` to `'success'` or `'error'` automatically on blur when validators are active. Setting `variant` manually overrides the feedback and breaks the visual contract.\n\n```html\n<!-- INCORRECT -->\n<mds-input name=\"codice\" variant=\"error\" tip=\"Valore non valido\"></mds-input>\n\n<!-- CORRECT -->\n<mds-input name=\"codice\" required tip=\"Inserisci un valore valido\"></mds-input>\n```\n\n#### Do Not Listen to Native `input` or `change` Events\n\nThe native `change` event does not cross the shadow boundary, and `input` reports only typing, not the values set by the steppers, the dictation or a script. Use the documented `mdsInputChange` event instead, which fires for every value change.\n\n```javascript\n// INCORRECT\ndocument.querySelector('mds-input').addEventListener('input', (e) => {\n console.log(e.target.value);\n});\n\n// CORRECT\ndocument.querySelector('mds-input').addEventListener('mdsInputChange', (e) => {\n console.log(e.detail.value);\n});\n```\n\n#### Do Not Use `type=\"number\"` Native Browser Spinners and Then Override the Input\n\nThe component renders its own increment/decrement buttons and hides the native browser spinners. Do not try to re-enable them via CSS, and do not add inline JS `stepUp`/`stepDown` calls - use the `controlsLayout` and `controlsIcon` props to configure the built-in controls.\n\n```html\n<!-- INCORRECT -->\n<mds-input type=\"number\" style=\"-moz-appearance: auto;\"></mds-input>\n\n<!-- CORRECT -->\n<mds-input\n type=\"number\"\n controls-layout=\"horizontal\"\n controls-icon=\"arithmetic\"\n min=\"0\"\n max=\"100\"\n></mds-input>\n```\n\n#### Do Not Use a Legacy or Invalid `type` Value\n\n`<mds-input>` accepts a specific set of `type` values: `text`, `email`, `number`, `password`, `search`, `tel`, `url`, `date`, `time`, `textarea`, `cf`, `piva`, `cc`, `isbn`. Supplying anything else (e.g. `\"checkbox\"`, `\"radio\"`, `\"file\"`) is passed straight to the inner native `<input>`, which renders a bare native control that the component neither styles nor reports correctly to the form. Use the dedicated Magma component for those controls.\n\n```html\n<!-- INCORRECT -->\n<mds-input type=\"checkbox\" name=\"accetto\"></mds-input>\n<mds-input type=\"file\" name=\"allegato\"></mds-input>\n\n<!-- CORRECT -->\n<mds-input-switch name=\"accetto\"></mds-input-switch>\n<mds-input-upload name=\"allegato\"></mds-input-upload>\n```\n\n#### Do Not Use `placeholder` as the Accessible Label\n\n`placeholder` disappears on input and is never read as a label by assistive tech. Always pair `<mds-input>` with [`mds-input-field`](../mds-input-field/AGENTS.md) (which shows a visible label and passes it down as the accessible name) or supply `aria-label` directly on the host.\n\n```html\n<!-- INCORRECT -->\n<mds-input name=\"ricerca\" placeholder=\"Cerca per nome\"></mds-input>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Cerca per nome\">\n <mds-input name=\"ricerca\" placeholder=\"Cerca per nome\"></mds-input>\n</mds-input-field>\n```\n\n#### Do Not Pierce the Shadow DOM to Style Internal Parts\n\nThe supported customization surface is the public `--mds-input-*` CSS custom properties plus the documented shadow parts (`field`, `tip-top`, `tip-bottom`, `tip-count`, `password-toggle-button`, `counter-button-increase`, `counter-button-decrease`, `mic-toggle-button`). Targeting undocumented internals via `>>>` or arbitrary class names couples your code to the Shadow DOM implementation.\n\n```css\n/* INCORRECT */\nmds-input >>> .input {\n border: 2px solid red;\n}\n\n/* CORRECT */\nmds-input {\n --mds-input-ring: 0 0 0 2px rgb(var(--magma-danger-border));\n --mds-input-background: rgb(var(--magma-danger-wash-base));\n}\nmds-input::part(field) {\n font-style: italic;\n}\n```\n"
60
64
  },
61
65
  "props": [
62
66
  {
@@ -1526,82 +1530,98 @@
1526
1530
  {
1527
1531
  "name": "--mds-input-background",
1528
1532
  "annotation": "prop",
1529
- "docs": "The background color of the input field."
1533
+ "docs": "The background color of the input field.",
1534
+ "visibility": "public"
1530
1535
  },
1531
1536
  {
1532
1537
  "name": "--mds-input-icon-color",
1533
1538
  "annotation": "prop",
1534
- "docs": "The color of the icons inside the input."
1539
+ "docs": "The color of the icons inside the input.",
1540
+ "visibility": "internal"
1535
1541
  },
1536
1542
  {
1537
1543
  "name": "--mds-input-placeholder-default-color",
1538
1544
  "annotation": "prop",
1539
- "docs": "The placeholder color in the default state."
1545
+ "docs": "The placeholder color in the default state.",
1546
+ "visibility": "internal"
1540
1547
  },
1541
1548
  {
1542
1549
  "name": "--mds-input-placeholder-focus-color",
1543
1550
  "annotation": "prop",
1544
- "docs": "The placeholder color when the input is focused."
1551
+ "docs": "The placeholder color when the input is focused.",
1552
+ "visibility": "internal"
1545
1553
  },
1546
1554
  {
1547
1555
  "name": "--mds-input-placeholder-hover-color",
1548
1556
  "annotation": "prop",
1549
- "docs": "The placeholder color when the input is hovered."
1557
+ "docs": "The placeholder color when the input is hovered.",
1558
+ "visibility": "internal"
1550
1559
  },
1551
1560
  {
1552
1561
  "name": "--mds-input-ring",
1553
1562
  "annotation": "prop",
1554
- "docs": "The outline ring applied to the input on interactive states."
1563
+ "docs": "The outline ring applied to the input on interactive states.",
1564
+ "visibility": "public"
1555
1565
  },
1556
1566
  {
1557
1567
  "name": "--mds-input-shadow",
1558
1568
  "annotation": "prop",
1559
- "docs": "The box-shadow applied to the input component."
1569
+ "docs": "The box-shadow applied to the input component.",
1570
+ "visibility": "public"
1560
1571
  },
1561
1572
  {
1562
1573
  "name": "--mds-input-textarea-field-sizing",
1563
1574
  "annotation": "prop",
1564
- "docs": "The field-sizing behavior of the textarea."
1575
+ "docs": "The field-sizing behavior of the textarea.",
1576
+ "visibility": "internal"
1565
1577
  },
1566
1578
  {
1567
1579
  "name": "--mds-input-textarea-max-height",
1568
1580
  "annotation": "prop",
1569
- "docs": "The max-height applied to the textarea."
1581
+ "docs": "The max-height applied to the textarea.",
1582
+ "visibility": "public"
1570
1583
  },
1571
1584
  {
1572
1585
  "name": "--mds-input-textarea-min-height",
1573
1586
  "annotation": "prop",
1574
- "docs": "The min-height applied to the textarea."
1587
+ "docs": "The min-height applied to the textarea.",
1588
+ "visibility": "public"
1575
1589
  },
1576
1590
  {
1577
1591
  "name": "--mds-input-textarea-resize",
1578
1592
  "annotation": "prop",
1579
- "docs": "Controls whether the textarea is resizable."
1593
+ "docs": "Controls whether the textarea is resizable.",
1594
+ "visibility": "public"
1580
1595
  },
1581
1596
  {
1582
1597
  "name": "--mds-input-tip-background",
1583
1598
  "annotation": "prop",
1584
- "docs": "The background color of the input tip/inline help."
1599
+ "docs": "The background color of the input tip/inline help.",
1600
+ "visibility": "public"
1585
1601
  },
1586
1602
  {
1587
1603
  "name": "--mds-input-tip-horizontal-offset",
1588
1604
  "annotation": "prop",
1589
- "docs": "The default horizontal offset applied to the input tip"
1605
+ "docs": "The default horizontal offset applied to the input tip",
1606
+ "visibility": "internal"
1590
1607
  },
1591
1608
  {
1592
1609
  "name": "--mds-input-tip-horizontal-offset-focused",
1593
1610
  "annotation": "prop",
1594
- "docs": "The horizontal offset applied when the input tip is focused"
1611
+ "docs": "The horizontal offset applied when the input tip is focused",
1612
+ "visibility": "internal"
1595
1613
  },
1596
1614
  {
1597
1615
  "name": "--mds-input-tip-vertical-offset",
1598
1616
  "annotation": "prop",
1599
- "docs": "The vertical offset applied to the input tip"
1617
+ "docs": "The vertical offset applied to the input tip",
1618
+ "visibility": "internal"
1600
1619
  },
1601
1620
  {
1602
1621
  "name": "--mds-input-variant-color-rgb",
1603
1622
  "annotation": "prop",
1604
- "docs": "The raw RGB channels used for variant-driven styling."
1623
+ "docs": "The raw RGB channels used for variant-driven styling.",
1624
+ "visibility": "public"
1605
1625
  }
1606
1626
  ],
1607
1627
  "slots": [],
@@ -15,22 +15,22 @@ mds-spinner {
15
15
 
16
16
 
17
17
  /**
18
- * @prop --mds-input-background: The background color of the input field.
18
+ * @prop --mds-input-background: Public. The background color of the input field.
19
19
  * @prop --mds-input-icon-color: The color of the icons inside the input.
20
20
  * @prop --mds-input-placeholder-default-color: The placeholder color in the default state.
21
21
  * @prop --mds-input-placeholder-focus-color: The placeholder color when the input is focused.
22
22
  * @prop --mds-input-placeholder-hover-color: The placeholder color when the input is hovered.
23
- * @prop --mds-input-ring: The outline ring applied to the input on interactive states.
24
- * @prop --mds-input-shadow: The box-shadow applied to the input component.
23
+ * @prop --mds-input-ring: Public. The outline ring applied to the input on interactive states.
24
+ * @prop --mds-input-shadow: Public. The box-shadow applied to the input component.
25
25
  * @prop --mds-input-textarea-field-sizing: The field-sizing behavior of the textarea.
26
- * @prop --mds-input-textarea-max-height: The max-height applied to the textarea.
27
- * @prop --mds-input-textarea-min-height: The min-height applied to the textarea.
28
- * @prop --mds-input-textarea-resize: Controls whether the textarea is resizable.
29
- * @prop --mds-input-tip-background: The background color of the input tip/inline help.
26
+ * @prop --mds-input-textarea-max-height: Public. The max-height applied to the textarea.
27
+ * @prop --mds-input-textarea-min-height: Public. The min-height applied to the textarea.
28
+ * @prop --mds-input-textarea-resize: Public. Controls whether the textarea is resizable.
29
+ * @prop --mds-input-tip-background: Public. The background color of the input tip/inline help.
30
30
  * @prop --mds-input-tip-horizontal-offset-focused: The horizontal offset applied when the input tip is focused
31
31
  * @prop --mds-input-tip-horizontal-offset: The default horizontal offset applied to the input tip
32
32
  * @prop --mds-input-tip-vertical-offset: The vertical offset applied to the input tip
33
- * @prop --mds-input-variant-color-rgb: The raw RGB channels used for variant-driven styling.
33
+ * @prop --mds-input-variant-color-rgb: Public. The raw RGB channels used for variant-driven styling.
34
34
  */
35
35
 
36
36
  /* ❌ Not supported: box-shadow cannot be expressed with @property syntax
@@ -18,7 +18,7 @@ import localeEn from "./meta/locale.en.json";
18
18
  import localeEs from "./meta/locale.es.json";
19
19
  import localeIt from "./meta/locale.it.json";
20
20
  import { createInputValidationManager, } from "./meta/input-type/InputValidationManager";
21
- import { maxLenghtValidator, maxValidator, minLenghtValidator, minValidator, patternValidator, requiredValidor, } from "./meta/validators";
21
+ import { maxLengthValidator, maxValidator, minLengthValidator, minValidator, patternValidator, requiredValidor, } from "./meta/validators";
22
22
  import { validityProblem } from "./meta/validity";
23
23
  import { hashRandomValue } from "../../common/aria";
24
24
  import { preferenceStore } from "../../common/preference";
@@ -33,6 +33,7 @@ import { preferenceStore } from "../../common/preference";
33
33
  * @part tip-count - Selects the mds-input-tip-item shown when maxlength attribute is set, can be used to hide it if needed
34
34
  * @part tip-top - Selects the verbose status of input on top of element
35
35
  * @part tip-bottom - Selects the verbose status of input on bottom of element
36
+ * @category forms
36
37
  */
37
38
  export class MdsInput {
38
39
  constructor() {
@@ -327,9 +328,9 @@ export class MdsInput {
327
328
  if (min !== undefined)
328
329
  validator.addValidator(minValidator(min));
329
330
  if (this.maxlength !== undefined && this.maxlength !== 0 && !Number.isNaN(this.maxlength))
330
- validator.addValidator(maxLenghtValidator(this.maxlength));
331
+ validator.addValidator(maxLengthValidator(this.maxlength));
331
332
  if (this.minlength !== undefined && this.minlength !== 0 && !Number.isNaN(this.minlength))
332
- validator.addValidator(minLenghtValidator(this.minlength));
333
+ validator.addValidator(minLengthValidator(this.minlength));
333
334
  const pattern = this.patternApplies() ? patternValidator((_b = this.pattern) !== null && _b !== void 0 ? _b : '') : null;
334
335
  if (pattern)
335
336
  validator.addValidator(pattern);
@@ -359,7 +360,7 @@ export class MdsInput {
359
360
  const value = (_a = this.value) !== null && _a !== void 0 ? _a : '';
360
361
  const errors = this.inputValidation.validator.check(value);
361
362
  const problem = errors
362
- ? validityProblem(errors, value, {
363
+ ? validityProblem(errors, {
363
364
  max: this.numericBound(this.max),
364
365
  maxlength: this.maxlength,
365
366
  min: this.numericBound(this.min),
@@ -401,13 +402,18 @@ export class MdsInput {
401
402
  * Emits the change event when the component value changes
402
403
  */
403
404
  valueChanged() {
404
- var _a;
405
+ var _a, _b;
405
406
  this.changeEvent.emit({ value: this.value });
406
407
  setFormValue(this.internals, (_a = this.value) !== null && _a !== void 0 ? _a : null);
407
408
  this.updateFormValidity();
408
409
  if (this.maxlength !== undefined) {
409
410
  this.countMaxLength();
410
411
  }
412
+ if (!this.validated) {
413
+ // pristine field: only the required tip follows, the variant waits for the first blur
414
+ this.isValid = !(this.required && ((_b = this.value) !== null && _b !== void 0 ? _b : '') === '');
415
+ return;
416
+ }
411
417
  // if is necessary for skip validation when reset input to retype correct value, validation is always onBlur
412
418
  if (this.value === '')
413
419
  return;
@@ -509,9 +515,9 @@ export class MdsInput {
509
515
  }
510
516
  render() {
511
517
  var _a, _b, _c;
512
- return (h(Host, { key: 'efb35dcc0b742ba1509ad2b830e91bdbcdc64034', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, this.type === 'number' && this.controlsLayout === 'horizontal' && (h("mds-button", { key: 'c89816eefd4e3c86e9f5cb8efdd4e9e4cac013fb', class: "counter-button counter-button--horizontal counter-button--decrease", icon: this.controlsIcon === 'arrow' ? miBaselineArrowDown : miBaselineRemove, disabled: !this.canEdit(), onClick: this.stepDown, tabindex: "0", title: this.t.get('decrease'), variant: "dark", tone: "text", part: "counter-button-decrease" })), this.type === 'textarea' ? (h("textarea", { "aria-label": this.accessibleName, class: clsx('input', ((_a = this.icon) !== null && _a !== void 0 ? _a : this.await) && 'has-icon', this.mic && 'has-right-icon'), autoFocus: this.autofocus, disabled: this.isDisabled(), maxLength: this.maxlength, minLength: this.minlength, name: this.name, onBlur: this.onBlur, onFocus: this.onFocus, onInput: this.onInput, onKeyDown: this.onKeyDown, part: "field", placeholder: this.placeholder, readOnly: this.readonly, ref: (input) => (this.nativeInput = input), required: this.required, tabIndex: this.tabindex, value: this.value })) : (h("input", { "aria-label": this.accessibleName, class: clsx('input', ((_b = this.icon) !== null && _b !== void 0 ? _b : this.await) && 'has-icon', this.mic && 'has-right-icon'), autoComplete: this.autocomplete, autoFocus: this.autofocus, disabled: this.isDisabled(), max: this.max, maxLength: this.maxlength, min: this.min, minLength: this.minlength, name: this.name, onBlur: this.onBlur, onFocus: this.onFocus, onInput: this.onInput, onKeyDown: this.onKeyDown, pattern: this.pattern, list: this.datalistId, part: "field", placeholder: this.placeholder, readOnly: this.readonly, ref: (input) => (this.nativeInput = input), required: this.required, step: this.step, tabIndex: this.tabindex, type: this.type === 'password' && this.isPasswordVisible ? 'text' : this.type, value: this.value })), this.type === 'number' && this.controlsLayout === 'vertical' && (h("div", { key: 'd4465ae4fbc4b5bbecfd1571b7f29dca870180b5', class: "counter counter--vertical" }, h("mds-button", { key: '5bc2720ca21c359a12f2967ef5356f8dcc306398', class: "counter-button", icon: this.controlsIcon === 'arrow' ? miBaselineArrowUp : miBaselineAdd, disabled: !this.canEdit(), onClick: this.stepUp, tabindex: "0", title: this.t.get('increase'), variant: "dark", size: "sm", tone: "text", part: "counter-button-increase" }), h("mds-button", { key: '3191ebaec68dd562e77d0f4878a12f7d3172ddb0', class: "counter-button", icon: this.controlsIcon === 'arrow' ? miBaselineArrowDown : miBaselineRemove, disabled: !this.canEdit(), onClick: this.stepDown, tabindex: "0", title: this.t.get('decrease'), variant: "dark", size: "sm", tone: "text", part: "counter-button-decrease" }))), this.type === 'number' && this.controlsLayout === 'horizontal' && (h("mds-button", { key: '3b20de301e9dedb1199c6817fcc2c64e174eb285', class: "counter-button counter-button--horizontal counter-button--increase", variant: "dark", tone: "text", icon: this.controlsIcon === 'arrow' ? miBaselineArrowUp : miBaselineAdd, disabled: !this.canEdit(), onClick: this.stepUp, tabindex: "0", title: this.t.get('increase'), part: "counter-button-increase" })), this.type === 'password' && (h("mds-button", { key: 'a77641adbc14728de15ec2c42e9258bdc73ee843', class: "password-toggle-button", size: this.buttonSize(), variant: "dark", tone: "text", icon: this.isPasswordVisible ? miBaselineVisibleOff : miBaselineVisible, disabled: this.isDisabled(), onClick: this.handlePasswordToggleClick, tabindex: "0", title: this.isPasswordVisible ? this.t.get('hidePassword') : this.t.get('showPassword'), part: "password-toggle-button" })), this.type === 'password' && !this.isPasswordVisible && ((_c = this.value) === null || _c === void 0 ? void 0 : _c.length) > 0 && (h("div", { key: 'cdbc75f7f51691cd00ccbecb993d44fd5ff94546', class: "password-mask" }, h("div", { key: 'b2ea3b22453abda1e6bc9a91c5098f3972865e65', class: "password-mask-items", part: "password-mask-items" }, Array.from({ length: this.value.length }).map((_, index) => (h("div", { key: index, class: "password-mask-item", part: "password-mask-item" })))))), this.mic && (h("mds-button", { key: '129f16c964cb454a2c7308d92b10d32aa70a8502', class: clsx('mic-toggle-button', this.isRecording && 'mic-toggle-button--recording'), size: this.buttonSize(), icon: this.speechToTextIcon, disabled: !this.canEdit(), onClick: this.toggleTextRecognition, tabindex: "0", title: this.t.get(this.speechToTextLabelKey), variant: "dark", tone: "text", part: "mic-toggle-button" })), h("mds-input-tip", { key: '181559d569b9e8338211013c348a085916d48c06', position: "top", active: this.hasFocus, part: "tip-top" }, this.isDisabled() && (h("mds-input-tip-item", { key: '721e29e14e7476d50a7b16fc31498a1b2af8e279', expanded: true, variant: "disabled" })), this.readonly && h("mds-input-tip-item", { key: '575dd8c784c216dd07befb76b966dc6aedb898de', expanded: true, variant: "readonly" }), this.required && (h("mds-input-tip-item", { key: '57710fc275fd02ec64ea6da58716d6beeee10125', expanded: this.hasFocus, variant: this.isValid ? 'required-success' : 'required' }))), h("mds-input-tip", { key: '393dfcee4482388fb5554d68b659799f3bc04bca', position: "bottom", active: this.hasFocus, part: "tip-bottom" }, this.tip && (h("mds-input-tip-item", { key: 'd0d676da2ef65f5a7bad9651d0370d618f8ee9ef', expanded: true, variant: "text" }, this.tip)), this.maxlength && (h("mds-input-tip-item", { key: '9f3b52270f3affe4a3f8cfe81256939afc06cdc3', part: "tip-count", expanded: true, variant: this.countVariant }, this.currentLengthLabel))), this.datalist && (h("datalist", { key: 'a0ccb628b25c1f039d23c11f5e54685e84fcfa58', id: this.datalistId, class: "datalist" }, this.datalist.map((element, i) => {
518
+ return (h(Host, { key: 'c856932350cf53c57a145aef676005e79ff20e6e', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, this.type === 'number' && this.controlsLayout === 'horizontal' && (h("mds-button", { key: '7bfaf28b46faa29020389bc444c7da694b6b650a', class: "counter-button counter-button--horizontal counter-button--decrease", icon: this.controlsIcon === 'arrow' ? miBaselineArrowDown : miBaselineRemove, disabled: !this.canEdit(), onClick: this.stepDown, tabindex: "0", title: this.t.get('decrease'), variant: "dark", tone: "text", part: "counter-button-decrease" })), this.type === 'textarea' ? (h("textarea", { "aria-label": this.accessibleName, class: clsx('input', ((_a = this.icon) !== null && _a !== void 0 ? _a : this.await) && 'has-icon', this.mic && 'has-right-icon'), autoFocus: this.autofocus, disabled: this.isDisabled(), maxLength: this.maxlength, minLength: this.minlength, name: this.name, onBlur: this.onBlur, onFocus: this.onFocus, onInput: this.onInput, onKeyDown: this.onKeyDown, part: "field", placeholder: this.placeholder, readOnly: this.readonly, ref: (input) => (this.nativeInput = input), required: this.required, tabIndex: this.tabindex, value: this.value })) : (h("input", { "aria-label": this.accessibleName, class: clsx('input', ((_b = this.icon) !== null && _b !== void 0 ? _b : this.await) && 'has-icon', this.mic && 'has-right-icon'), autoComplete: this.autocomplete, autoFocus: this.autofocus, disabled: this.isDisabled(), max: this.max, maxLength: this.maxlength, min: this.min, minLength: this.minlength, name: this.name, onBlur: this.onBlur, onFocus: this.onFocus, onInput: this.onInput, onKeyDown: this.onKeyDown, pattern: this.pattern, list: this.datalistId, part: "field", placeholder: this.placeholder, readOnly: this.readonly, ref: (input) => (this.nativeInput = input), required: this.required, step: this.step, tabIndex: this.tabindex, type: this.type === 'password' && this.isPasswordVisible ? 'text' : this.type, value: this.value })), this.type === 'number' && this.controlsLayout === 'vertical' && (h("div", { key: 'cacebc13d3acd7e4b4cc5e07e1887f72e4d08f74', class: "counter counter--vertical" }, h("mds-button", { key: '8b99cb70002936c41d04e5f150cbe05dc08e27aa', class: "counter-button", icon: this.controlsIcon === 'arrow' ? miBaselineArrowUp : miBaselineAdd, disabled: !this.canEdit(), onClick: this.stepUp, tabindex: "0", title: this.t.get('increase'), variant: "dark", size: "sm", tone: "text", part: "counter-button-increase" }), h("mds-button", { key: '98e3d17c2ca0c06977a96418e3353babf95c4bac', class: "counter-button", icon: this.controlsIcon === 'arrow' ? miBaselineArrowDown : miBaselineRemove, disabled: !this.canEdit(), onClick: this.stepDown, tabindex: "0", title: this.t.get('decrease'), variant: "dark", size: "sm", tone: "text", part: "counter-button-decrease" }))), this.type === 'number' && this.controlsLayout === 'horizontal' && (h("mds-button", { key: '76109894dfd126d9145e854933afb9e78008e86f', class: "counter-button counter-button--horizontal counter-button--increase", variant: "dark", tone: "text", icon: this.controlsIcon === 'arrow' ? miBaselineArrowUp : miBaselineAdd, disabled: !this.canEdit(), onClick: this.stepUp, tabindex: "0", title: this.t.get('increase'), part: "counter-button-increase" })), this.type === 'password' && (h("mds-button", { key: '9ed861d527d875771dc1c225dedaa6da81fdeef5', class: "password-toggle-button", size: this.buttonSize(), variant: "dark", tone: "text", icon: this.isPasswordVisible ? miBaselineVisibleOff : miBaselineVisible, disabled: this.isDisabled(), onClick: this.handlePasswordToggleClick, tabindex: "0", title: this.isPasswordVisible ? this.t.get('hidePassword') : this.t.get('showPassword'), part: "password-toggle-button" })), this.type === 'password' && !this.isPasswordVisible && ((_c = this.value) === null || _c === void 0 ? void 0 : _c.length) > 0 && (h("div", { key: '966c2f5fba186b648add96c0476f201403b37915', class: "password-mask" }, h("div", { key: '70b9200edf7d1849afde6a9cfd58440913aba991', class: "password-mask-items", part: "password-mask-items" }, Array.from({ length: this.value.length }).map((_, index) => (h("div", { key: index, class: "password-mask-item", part: "password-mask-item" })))))), this.mic && (h("mds-button", { key: '58a4978feb6711380f36d12630ede5fed6717634', class: clsx('mic-toggle-button', this.isRecording && 'mic-toggle-button--recording'), size: this.buttonSize(), icon: this.speechToTextIcon, disabled: !this.canEdit(), onClick: this.toggleTextRecognition, tabindex: "0", title: this.t.get(this.speechToTextLabelKey), variant: "dark", tone: "text", part: "mic-toggle-button" })), h("mds-input-tip", { key: 'd412e7f0194b6506cff44b2e361bd72016fb30b4', position: "top", active: this.hasFocus, part: "tip-top" }, this.isDisabled() && (h("mds-input-tip-item", { key: 'f7728c3c0c2a2197b8c3b6d261085be5ff24f259', expanded: true, variant: "disabled" })), this.readonly && h("mds-input-tip-item", { key: '72f41be1624583beaea44f034ecc07dc285018a1', expanded: true, variant: "readonly" }), this.required && (h("mds-input-tip-item", { key: '5148ab8bdcafbc9944447814acb9c668954e8e93', expanded: this.hasFocus, variant: this.isValid ? 'required-success' : 'required' }))), h("mds-input-tip", { key: '1780e41f8078a17d2f558165f5a0a8e1ea50d851', position: "bottom", active: this.hasFocus, part: "tip-bottom" }, this.tip && (h("mds-input-tip-item", { key: 'bc1c15f578236bc52cff7b6998c47c6f71d542f9', expanded: true, variant: "text" }, this.tip)), this.maxlength && (h("mds-input-tip-item", { key: 'aa878fb04495702f3c5b9130c5e1aff052f2d382', part: "tip-count", expanded: true, variant: this.countVariant }, this.currentLengthLabel))), this.datalist && (h("datalist", { key: '269b2ff771e90ba4726fdbedbb60d15d1af3b94e', id: this.datalistId, class: "datalist" }, this.datalist.map((element, i) => {
513
519
  return h("option", { key: i, value: element });
514
- }))), this.icon && !this.await && (h("mds-icon", { key: 'ace2f759671fdc34802c39f9c3f07e07d07ed158', class: clsx('icon', this.variant), name: this.icon })), h("mds-spinner", { key: 'b963adc9d16baf4d557384a584aaa8f21f9454a4', running: this.await, class: clsx('await', this.variant) })));
520
+ }))), this.icon && !this.await && (h("mds-icon", { key: '35dfa9175625559bf332d960430030bf6b2db381', class: clsx('icon', this.variant), name: this.icon })), h("mds-spinner", { key: '50b49ee75f0c5217e0f3bb2cb95d9114a9ee1989', running: this.await, class: clsx('await', this.variant) })));
515
521
  }
516
522
  static get is() { return "mds-input"; }
517
523
  static get encapsulation() { return "shadow"; }
@@ -1,4 +1,4 @@
1
- import { Validator, ccValidatorFn, emailValidatorFn, isbnValidatorFn, pivaValidatorFn, urlValidatorFn, } from "../validators";
1
+ import { Validator, ccValidatorFn, emailValidatorFn, isbnValidatorFn, pivaValidatorFn, urlValidatorFn, validationMessage, } from "../validators";
2
2
  import { InputMaskPattern } from "./InputMaskPattern";
3
3
  // TODO use input mask when it will be supported by shadow dom
4
4
  // https://github.com/RobinHerbots/Inputmask/pull/2753
@@ -55,14 +55,14 @@ export function createInputValidationManager(type) {
55
55
  return null; // don't validate empty values to allow optional controls
56
56
  return InputMaskPattern.CF_Regex.test(input)
57
57
  ? null
58
- : { 'cf-regex': 'Codice fiscale inserito non corretto' };
58
+ : { 'cf-regex': validationMessage('validationCfRegex') };
59
59
  });
60
60
  inputManager.validator.addValidator((input) => {
61
61
  if (input === '')
62
62
  return null; // don't validate empty values to allow optional controls
63
63
  return input.length === 16
64
64
  ? null
65
- : { 'cf-length': 'Codice fiscale deve essere lungo 16 caratteri' };
65
+ : { 'cf-length': validationMessage('validationCfLength') };
66
66
  });
67
67
  break;
68
68
  case 'isbn':
@@ -1,3 +1,14 @@
1
+ import { Locale } from "../../../common/locale";
2
+ import localeEl from "./locale.el.json";
3
+ import localeEn from "./locale.en.json";
4
+ import localeEs from "./locale.es.json";
5
+ import localeIt from "./locale.it.json";
6
+ const messages = new Locale({ el: localeEl, en: localeEn, es: localeEs, it: localeIt });
7
+ /**
8
+ * The message of a failed validation, in the language of the page when the value is validated: a
9
+ * validator is built once, and the language can change after that.
10
+ */
11
+ export const validationMessage = (tag, context) => messages.get(tag, context);
1
12
  export const NullValidator = () => null;
2
13
  export const requiredValidor = (input) => {
3
14
  return input.length > 0 ? null : { required: '' };
@@ -10,7 +21,9 @@ export const maxValidator = (max) => {
10
21
  const value = parseFloat(input);
11
22
  // Controls with NaN values after parsing should be treated as not having a
12
23
  // maximum, per the HTML forms spec: https://www.w3.org/TR/html5/forms.html#attr-input-max
13
- return !isNaN(value) && value > max ? { max: `valore massimo ${max}` } : null;
24
+ return !isNaN(value) && value > max
25
+ ? { max: validationMessage('validationMax', { max }) }
26
+ : null;
14
27
  };
15
28
  };
16
29
  export const minValidator = (min) => {
@@ -21,26 +34,28 @@ export const minValidator = (min) => {
21
34
  const value = parseFloat(input);
22
35
  // Controls with NaN values after parsing should be treated as not having a
23
36
  // minimum, per the HTML forms spec: https://www.w3.org/TR/html5/forms.html#attr-input-min
24
- return !isNaN(value) && value < min ? { min: `valore minimo ${min}` } : null;
37
+ return !isNaN(value) && value < min
38
+ ? { min: validationMessage('validationMin', { min }) }
39
+ : null;
25
40
  };
26
41
  };
27
- export const maxLenghtValidator = (length) => {
42
+ export const maxLengthValidator = (length) => {
28
43
  return (input) => {
29
44
  if (input === '' || length === null) {
30
45
  return null; // don't validate empty values to allow optional controls
31
46
  }
32
47
  return input.length > length
33
- ? { minLenght: `La lunghezza massima accettata è ${length}` }
48
+ ? { maxlength: validationMessage('validationMaxlength', { maxlength: length }) }
34
49
  : null;
35
50
  };
36
51
  };
37
- export const minLenghtValidator = (length) => {
52
+ export const minLengthValidator = (length) => {
38
53
  return (input) => {
39
54
  if (input === '' || length === null) {
40
55
  return null; // don't validate empty values to allow optional controls
41
56
  }
42
57
  return input.length < length
43
- ? { minLenght: `La lunghezza minima accettata è ${length}` }
58
+ ? { minlength: validationMessage('validationMinlength', { minlength: length }) }
44
59
  : null;
45
60
  };
46
61
  };
@@ -68,7 +83,7 @@ export const patternValidator = (pattern) => {
68
83
  return (input) => {
69
84
  if (input === '')
70
85
  return null; // don't validate empty values to allow optional controls
71
- return expression.test(input) ? null : { pattern: 'formato non valido' };
86
+ return expression.test(input) ? null : { pattern: validationMessage('validationPattern') };
72
87
  };
73
88
  };
74
89
  // the valid email address of the HTML spec, the one a native type="email" checks
@@ -76,7 +91,7 @@ const emailExpression = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z
76
91
  export const emailValidatorFn = (input) => {
77
92
  if (input === '')
78
93
  return null; // don't validate empty values to allow optional controls
79
- return emailExpression.test(input) ? null : { email: 'indirizzo email non valido' };
94
+ return emailExpression.test(input) ? null : { email: validationMessage('validationEmail') };
80
95
  };
81
96
  // a native type="url" accepts an absolute URL, the one the URL parser reads without a base
82
97
  export const urlValidatorFn = (input) => {
@@ -87,7 +102,7 @@ export const urlValidatorFn = (input) => {
87
102
  return null;
88
103
  }
89
104
  catch (_a) {
90
- return { url: 'url non valido' };
105
+ return { url: validationMessage('validationUrl') };
91
106
  }
92
107
  };
93
108
  /**
@@ -97,7 +112,7 @@ export const urlValidatorFn = (input) => {
97
112
  export const pivaValidatorFn = (input) => {
98
113
  if (input === '')
99
114
  return null; // don't validate empty values to allow optional controls
100
- const error = { piva: 'partita iva non valida' };
115
+ const error = { piva: validationMessage('validationPiva') };
101
116
  if (!/^\d{11}$/.test(input))
102
117
  return error;
103
118
  const digits = input.split('').map(Number);
@@ -116,7 +131,7 @@ export const pivaValidatorFn = (input) => {
116
131
  export const ccValidatorFn = (input) => {
117
132
  if (input === '')
118
133
  return null; // don't validate empty values to allow optional controls
119
- const error = { cc: 'numero di carta non valido' };
134
+ const error = { cc: validationMessage('validationCc') };
120
135
  if (!/^\d+(?:[ -]\d+)*$/.test(input))
121
136
  return error;
122
137
  const digits = input.replace(/[ -]/g, '');
@@ -139,7 +154,7 @@ export const isbnValidatorFn = (input) => {
139
154
  if (input === '')
140
155
  return null; // don't validate empty values to allow optional controls
141
156
  if (Number.isNaN(input.slice(0, -1)) || (input.length !== 10 && input.length !== 13))
142
- return { 'isbn-error': 'formato isbn non correto' };
157
+ return { 'isbn-error': validationMessage('validationIsbnFormat') };
143
158
  const v = input.split('').map((v) => (v === 'X' ? 10 : Number(v)));
144
159
  let check = 0;
145
160
  // check isbn-10
@@ -157,7 +172,7 @@ export const isbnValidatorFn = (input) => {
157
172
  }, 0);
158
173
  check = numVerify % 10;
159
174
  }
160
- return check === 0 ? null : { 'isbn-error': 'codice isbn non valido' };
175
+ return check === 0 ? null : { 'isbn-error': validationMessage('validationIsbn') };
161
176
  };
162
177
  export class Validator {
163
178
  constructor() {