@maggioli-design-system/magma 2.6.0 → 2.7.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 (267) hide show
  1. package/AGENTS.md +1 -1
  2. package/CHANGELOG.md +24 -0
  3. package/agents/assets.md +23 -9
  4. package/agents/conventions.md +2 -1
  5. package/agents/lint.md +37 -9
  6. package/agents/mcp.md +6 -2
  7. package/agents/reporting.md +53 -2
  8. package/dist/collection/components/mds-accordion/AGENTS.md +1 -1
  9. package/dist/collection/components/mds-accordion/documentation.json +1 -1
  10. package/dist/collection/components/mds-accordion-item/AGENTS.md +1 -1
  11. package/dist/collection/components/mds-accordion-item/documentation.json +1 -1
  12. package/dist/collection/components/mds-accordion-timer/AGENTS.md +1 -1
  13. package/dist/collection/components/mds-accordion-timer/documentation.json +1 -1
  14. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +1 -1
  15. package/dist/collection/components/mds-accordion-timer-item/documentation.json +1 -1
  16. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  17. package/dist/collection/components/mds-author/documentation.json +1 -1
  18. package/dist/collection/components/mds-avatar/AGENTS.md +1 -1
  19. package/dist/collection/components/mds-avatar/documentation.json +1 -1
  20. package/dist/collection/components/mds-avatar-stack/AGENTS.md +1 -1
  21. package/dist/collection/components/mds-avatar-stack/documentation.json +1 -1
  22. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +1 -1
  23. package/dist/collection/components/mds-avatar-stack-item/documentation.json +1 -1
  24. package/dist/collection/components/mds-badge/AGENTS.md +1 -1
  25. package/dist/collection/components/mds-badge/documentation.json +1 -1
  26. package/dist/collection/components/mds-banner/AGENTS.md +1 -1
  27. package/dist/collection/components/mds-banner/documentation.json +1 -1
  28. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +1 -1
  29. package/dist/collection/components/mds-benchmark-bar/documentation.json +1 -1
  30. package/dist/collection/components/mds-bibliography/AGENTS.md +1 -1
  31. package/dist/collection/components/mds-bibliography/documentation.json +1 -1
  32. package/dist/collection/components/mds-book/AGENTS.md +1 -1
  33. package/dist/collection/components/mds-book/documentation.json +1 -1
  34. package/dist/collection/components/mds-breadcrumb/AGENTS.md +1 -1
  35. package/dist/collection/components/mds-breadcrumb/documentation.json +1 -1
  36. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +1 -1
  37. package/dist/collection/components/mds-breadcrumb-item/documentation.json +1 -1
  38. package/dist/collection/components/mds-button/AGENTS.md +1 -1
  39. package/dist/collection/components/mds-button/documentation.json +1 -1
  40. package/dist/collection/components/mds-button-dropdown/AGENTS.md +1 -1
  41. package/dist/collection/components/mds-button-dropdown/documentation.json +1 -1
  42. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  43. package/dist/collection/components/mds-button-group/documentation.json +1 -1
  44. package/dist/collection/components/mds-calendar/AGENTS.md +1 -1
  45. package/dist/collection/components/mds-calendar/documentation.json +1 -1
  46. package/dist/collection/components/mds-calendar-cell/AGENTS.md +1 -1
  47. package/dist/collection/components/mds-calendar-cell/documentation.json +1 -1
  48. package/dist/collection/components/mds-card/AGENTS.md +1 -1
  49. package/dist/collection/components/mds-card/documentation.json +1 -1
  50. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  51. package/dist/collection/components/mds-card-content/documentation.json +1 -1
  52. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  53. package/dist/collection/components/mds-card-footer/documentation.json +1 -1
  54. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  55. package/dist/collection/components/mds-card-header/documentation.json +1 -1
  56. package/dist/collection/components/mds-card-media/AGENTS.md +1 -1
  57. package/dist/collection/components/mds-card-media/documentation.json +1 -1
  58. package/dist/collection/components/mds-chip/AGENTS.md +1 -1
  59. package/dist/collection/components/mds-chip/documentation.json +1 -1
  60. package/dist/collection/components/mds-details/AGENTS.md +1 -1
  61. package/dist/collection/components/mds-details/documentation.json +1 -1
  62. package/dist/collection/components/mds-dropdown/AGENTS.md +1 -1
  63. package/dist/collection/components/mds-dropdown/documentation.json +1 -1
  64. package/dist/collection/components/mds-emoji/AGENTS.md +1 -1
  65. package/dist/collection/components/mds-emoji/documentation.json +1 -1
  66. package/dist/collection/components/mds-entity/AGENTS.md +1 -1
  67. package/dist/collection/components/mds-entity/documentation.json +1 -1
  68. package/dist/collection/components/mds-file/AGENTS.md +1 -1
  69. package/dist/collection/components/mds-file/documentation.json +1 -1
  70. package/dist/collection/components/mds-file-preview/AGENTS.md +1 -1
  71. package/dist/collection/components/mds-file-preview/documentation.json +1 -1
  72. package/dist/collection/components/mds-filter/AGENTS.md +1 -1
  73. package/dist/collection/components/mds-filter/documentation.json +1 -1
  74. package/dist/collection/components/mds-filter-item/AGENTS.md +1 -1
  75. package/dist/collection/components/mds-filter-item/documentation.json +1 -1
  76. package/dist/collection/components/mds-header/AGENTS.md +1 -1
  77. package/dist/collection/components/mds-header/documentation.json +1 -1
  78. package/dist/collection/components/mds-header-bar/AGENTS.md +1 -1
  79. package/dist/collection/components/mds-header-bar/documentation.json +1 -1
  80. package/dist/collection/components/mds-help/AGENTS.md +1 -1
  81. package/dist/collection/components/mds-help/documentation.json +1 -1
  82. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +1 -1
  83. package/dist/collection/components/mds-horizontal-scroll/documentation.json +1 -1
  84. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  85. package/dist/collection/components/mds-hr/documentation.json +1 -1
  86. package/dist/collection/components/mds-icon/AGENTS.md +1 -1
  87. package/dist/collection/components/mds-icon/documentation.json +1 -1
  88. package/dist/collection/components/mds-img/AGENTS.md +1 -1
  89. package/dist/collection/components/mds-img/documentation.json +1 -1
  90. package/dist/collection/components/mds-input/AGENTS.md +1 -1
  91. package/dist/collection/components/mds-input/documentation.json +1 -1
  92. package/dist/collection/components/mds-input-date/AGENTS.md +1 -1
  93. package/dist/collection/components/mds-input-date/documentation.json +1 -1
  94. package/dist/collection/components/mds-input-date-range/AGENTS.md +1 -1
  95. package/dist/collection/components/mds-input-date-range/documentation.json +1 -1
  96. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +1 -1
  97. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +1 -1
  98. package/dist/collection/components/mds-input-field/AGENTS.md +1 -1
  99. package/dist/collection/components/mds-input-field/documentation.json +1 -1
  100. package/dist/collection/components/mds-input-otp/AGENTS.md +1 -1
  101. package/dist/collection/components/mds-input-otp/documentation.json +1 -1
  102. package/dist/collection/components/mds-input-range/AGENTS.md +1 -1
  103. package/dist/collection/components/mds-input-range/documentation.json +1 -1
  104. package/dist/collection/components/mds-input-select/AGENTS.md +1 -1
  105. package/dist/collection/components/mds-input-select/documentation.json +1 -1
  106. package/dist/collection/components/mds-input-switch/AGENTS.md +1 -1
  107. package/dist/collection/components/mds-input-switch/documentation.json +1 -1
  108. package/dist/collection/components/mds-input-tip/AGENTS.md +1 -1
  109. package/dist/collection/components/mds-input-tip/documentation.json +1 -1
  110. package/dist/collection/components/mds-input-tip-item/AGENTS.md +1 -1
  111. package/dist/collection/components/mds-input-tip-item/documentation.json +1 -1
  112. package/dist/collection/components/mds-input-upload/AGENTS.md +1 -1
  113. package/dist/collection/components/mds-input-upload/documentation.json +1 -1
  114. package/dist/collection/components/mds-keyboard/AGENTS.md +1 -1
  115. package/dist/collection/components/mds-keyboard/documentation.json +1 -1
  116. package/dist/collection/components/mds-keyboard-key/AGENTS.md +1 -1
  117. package/dist/collection/components/mds-keyboard-key/documentation.json +1 -1
  118. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  119. package/dist/collection/components/mds-kpi/documentation.json +1 -1
  120. package/dist/collection/components/mds-kpi-item/AGENTS.md +1 -1
  121. package/dist/collection/components/mds-kpi-item/documentation.json +1 -1
  122. package/dist/collection/components/mds-label/AGENTS.md +1 -1
  123. package/dist/collection/components/mds-label/documentation.json +1 -1
  124. package/dist/collection/components/mds-link/AGENTS.md +1 -1
  125. package/dist/collection/components/mds-link/documentation.json +1 -1
  126. package/dist/collection/components/mds-list/AGENTS.md +1 -1
  127. package/dist/collection/components/mds-list/documentation.json +1 -1
  128. package/dist/collection/components/mds-list-item/AGENTS.md +1 -1
  129. package/dist/collection/components/mds-list-item/documentation.json +1 -1
  130. package/dist/collection/components/mds-mention/AGENTS.md +1 -1
  131. package/dist/collection/components/mds-mention/documentation.json +1 -1
  132. package/dist/collection/components/mds-modal/AGENTS.md +1 -1
  133. package/dist/collection/components/mds-modal/documentation.json +1 -1
  134. package/dist/collection/components/mds-note/AGENTS.md +1 -1
  135. package/dist/collection/components/mds-note/documentation.json +1 -1
  136. package/dist/collection/components/mds-notification/AGENTS.md +1 -1
  137. package/dist/collection/components/mds-notification/documentation.json +1 -1
  138. package/dist/collection/components/mds-paginator/AGENTS.md +1 -1
  139. package/dist/collection/components/mds-paginator/documentation.json +1 -1
  140. package/dist/collection/components/mds-paginator-item/AGENTS.md +1 -1
  141. package/dist/collection/components/mds-paginator-item/documentation.json +1 -1
  142. package/dist/collection/components/mds-policy-ai/AGENTS.md +1 -1
  143. package/dist/collection/components/mds-policy-ai/documentation.json +1 -1
  144. package/dist/collection/components/mds-pref/AGENTS.md +1 -1
  145. package/dist/collection/components/mds-pref/documentation.json +1 -1
  146. package/dist/collection/components/mds-pref-animation/AGENTS.md +1 -1
  147. package/dist/collection/components/mds-pref-animation/documentation.json +1 -1
  148. package/dist/collection/components/mds-pref-consumption/AGENTS.md +1 -1
  149. package/dist/collection/components/mds-pref-consumption/documentation.json +1 -1
  150. package/dist/collection/components/mds-pref-contrast/AGENTS.md +1 -1
  151. package/dist/collection/components/mds-pref-contrast/documentation.json +1 -1
  152. package/dist/collection/components/mds-pref-language/AGENTS.md +1 -1
  153. package/dist/collection/components/mds-pref-language/documentation.json +1 -1
  154. package/dist/collection/components/mds-pref-language-item/AGENTS.md +1 -1
  155. package/dist/collection/components/mds-pref-language-item/documentation.json +1 -1
  156. package/dist/collection/components/mds-pref-mode/AGENTS.md +1 -1
  157. package/dist/collection/components/mds-pref-mode/documentation.json +1 -1
  158. package/dist/collection/components/mds-pref-theme/AGENTS.md +1 -1
  159. package/dist/collection/components/mds-pref-theme/documentation.json +1 -1
  160. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +1 -1
  161. package/dist/collection/components/mds-pref-theme-item/documentation.json +1 -1
  162. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  163. package/dist/collection/components/mds-price-table/documentation.json +1 -1
  164. package/dist/collection/components/mds-price-table-features/AGENTS.md +1 -1
  165. package/dist/collection/components/mds-price-table-features/documentation.json +1 -1
  166. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +1 -1
  167. package/dist/collection/components/mds-price-table-features-cell/documentation.json +1 -1
  168. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +1 -1
  169. package/dist/collection/components/mds-price-table-features-row/documentation.json +1 -1
  170. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  171. package/dist/collection/components/mds-price-table-header/documentation.json +1 -1
  172. package/dist/collection/components/mds-price-table-list/AGENTS.md +1 -1
  173. package/dist/collection/components/mds-price-table-list/documentation.json +1 -1
  174. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +1 -1
  175. package/dist/collection/components/mds-price-table-list-item/documentation.json +1 -1
  176. package/dist/collection/components/mds-progress/AGENTS.md +1 -1
  177. package/dist/collection/components/mds-progress/documentation.json +1 -1
  178. package/dist/collection/components/mds-push-notification/AGENTS.md +1 -1
  179. package/dist/collection/components/mds-push-notification/documentation.json +1 -1
  180. package/dist/collection/components/mds-push-notification-item/AGENTS.md +1 -1
  181. package/dist/collection/components/mds-push-notification-item/documentation.json +1 -1
  182. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  183. package/dist/collection/components/mds-quote/documentation.json +1 -1
  184. package/dist/collection/components/mds-radial-menu/AGENTS.md +1 -1
  185. package/dist/collection/components/mds-radial-menu/documentation.json +1 -1
  186. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +1 -1
  187. package/dist/collection/components/mds-radial-menu-item/documentation.json +1 -1
  188. package/dist/collection/components/mds-radial-progress/AGENTS.md +1 -1
  189. package/dist/collection/components/mds-radial-progress/documentation.json +1 -1
  190. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  191. package/dist/collection/components/mds-separator/documentation.json +1 -1
  192. package/dist/collection/components/mds-spinner/AGENTS.md +1 -1
  193. package/dist/collection/components/mds-spinner/documentation.json +1 -1
  194. package/dist/collection/components/mds-status-bar/AGENTS.md +1 -1
  195. package/dist/collection/components/mds-status-bar/documentation.json +1 -1
  196. package/dist/collection/components/mds-stepper-bar/AGENTS.md +1 -1
  197. package/dist/collection/components/mds-stepper-bar/documentation.json +1 -1
  198. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +1 -1
  199. package/dist/collection/components/mds-stepper-bar-item/documentation.json +1 -1
  200. package/dist/collection/components/mds-tab/AGENTS.md +1 -1
  201. package/dist/collection/components/mds-tab/documentation.json +1 -1
  202. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  203. package/dist/collection/components/mds-tab-bar/documentation.json +1 -1
  204. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +1 -1
  205. package/dist/collection/components/mds-tab-bar-item/documentation.json +1 -1
  206. package/dist/collection/components/mds-tab-item/AGENTS.md +1 -1
  207. package/dist/collection/components/mds-tab-item/documentation.json +1 -1
  208. package/dist/collection/components/mds-table/AGENTS.md +1 -1
  209. package/dist/collection/components/mds-table/documentation.json +1 -1
  210. package/dist/collection/components/mds-table-body/AGENTS.md +1 -1
  211. package/dist/collection/components/mds-table-body/documentation.json +1 -1
  212. package/dist/collection/components/mds-table-cell/AGENTS.md +1 -1
  213. package/dist/collection/components/mds-table-cell/documentation.json +1 -1
  214. package/dist/collection/components/mds-table-footer/AGENTS.md +1 -1
  215. package/dist/collection/components/mds-table-footer/documentation.json +1 -1
  216. package/dist/collection/components/mds-table-header/AGENTS.md +1 -1
  217. package/dist/collection/components/mds-table-header/documentation.json +1 -1
  218. package/dist/collection/components/mds-table-header-cell/AGENTS.md +1 -1
  219. package/dist/collection/components/mds-table-header-cell/documentation.json +1 -1
  220. package/dist/collection/components/mds-table-row/AGENTS.md +1 -1
  221. package/dist/collection/components/mds-table-row/documentation.json +1 -1
  222. package/dist/collection/components/mds-text/AGENTS.md +1 -1
  223. package/dist/collection/components/mds-text/documentation.json +1 -1
  224. package/dist/collection/components/mds-toast/AGENTS.md +1 -1
  225. package/dist/collection/components/mds-toast/documentation.json +1 -1
  226. package/dist/collection/components/mds-toast-region/AGENTS.md +1 -1
  227. package/dist/collection/components/mds-toast-region/documentation.json +1 -1
  228. package/dist/collection/components/mds-tooltip/AGENTS.md +1 -1
  229. package/dist/collection/components/mds-tooltip/documentation.json +1 -1
  230. package/dist/collection/components/mds-tree/AGENTS.md +1 -1
  231. package/dist/collection/components/mds-tree/documentation.json +1 -1
  232. package/dist/collection/components/mds-tree-item/AGENTS.md +1 -1
  233. package/dist/collection/components/mds-tree-item/documentation.json +1 -1
  234. package/dist/collection/components/mds-url-view/AGENTS.md +1 -1
  235. package/dist/collection/components/mds-url-view/documentation.json +1 -1
  236. package/dist/collection/components/mds-usage/AGENTS.md +1 -1
  237. package/dist/collection/components/mds-usage/documentation.json +1 -1
  238. package/dist/collection/components/mds-video-wall/AGENTS.md +1 -1
  239. package/dist/collection/components/mds-video-wall/documentation.json +1 -1
  240. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  241. package/dist/collection/components/mds-zero/documentation.json +1 -1
  242. package/dist/documentation.json +1 -1
  243. package/dist/lint/core/checks.d.ts +16 -2
  244. package/dist/lint/core/checks.js +32 -24
  245. package/dist/lint/core/data.d.ts +8 -0
  246. package/dist/lint/core/data.js +15 -0
  247. package/dist/lint/core/element.d.ts +1 -1
  248. package/dist/lint/eslint/adapters.d.ts +2 -0
  249. package/dist/lint/eslint/adapters.js +50 -13
  250. package/dist/lint/eslint/index.js +5 -4
  251. package/dist/lint/mcp/checks.js +60 -24
  252. package/dist/lint/mcp/components.js +7 -7
  253. package/dist/lint/mcp/context.d.ts +11 -0
  254. package/dist/lint/mcp/context.js +11 -0
  255. package/dist/lint/mcp/icons.js +46 -20
  256. package/dist/lint/mcp/protocol.d.ts +17 -0
  257. package/dist/lint/mcp/protocol.js +15 -10
  258. package/dist/lint/mcp/server.d.ts +17 -0
  259. package/dist/lint/mcp/server.js +7 -1
  260. package/dist/lint/mcp/tokens.d.ts +15 -0
  261. package/dist/lint/mcp/tokens.js +170 -48
  262. package/dist/lint/mcp/tools.json +962 -0
  263. package/dist/lint/stylelint/index.js +80 -14
  264. package/dist/lint/stylelint/recommended.js +1 -0
  265. package/dist/lint/stylelint/strict.js +1 -0
  266. package/dist/stats.json +1 -1
  267. package/package.json +2 -1
@@ -0,0 +1,962 @@
1
+ {
2
+ "tools": [
3
+ {
4
+ "name": "find_component",
5
+ "title": "Find a Magma component",
6
+ "description": "Find the Magma components that fit a need, described in words (\"a date range picker\", \"a dismissible notice\"). Returns the tags with what each one is for; read the one you pick with get_component.",
7
+ "inputSchema": {
8
+ "type": "object",
9
+ "properties": {
10
+ "query": {
11
+ "type": "string",
12
+ "description": "What the component has to do, in a few words."
13
+ },
14
+ "limit": {
15
+ "type": "number",
16
+ "description": "How many to return, 8 by default."
17
+ }
18
+ },
19
+ "required": [
20
+ "query"
21
+ ]
22
+ },
23
+ "outputSchema": {
24
+ "type": "object",
25
+ "properties": {
26
+ "components": {
27
+ "type": "array",
28
+ "items": {
29
+ "type": "object",
30
+ "properties": {
31
+ "tag": {
32
+ "type": "string"
33
+ },
34
+ "summary": {
35
+ "type": "string"
36
+ },
37
+ "score": {
38
+ "type": "number"
39
+ }
40
+ },
41
+ "required": [
42
+ "tag",
43
+ "summary",
44
+ "score"
45
+ ]
46
+ }
47
+ },
48
+ "gap": {
49
+ "type": "string",
50
+ "description": "Set when Magma has nothing for the question: a gap to report."
51
+ }
52
+ },
53
+ "required": [
54
+ "components"
55
+ ]
56
+ },
57
+ "annotations": {
58
+ "readOnlyHint": true,
59
+ "openWorldHint": false
60
+ }
61
+ },
62
+ {
63
+ "name": "get_component",
64
+ "title": "Read the API of a Magma component",
65
+ "description": "The API of one Magma component in the installed version: props with their type, allowed values and default, events with their detail, methods, slots, parts and public CSS custom properties (the only ones a product sets; the internal ones are counted, they may change in any release), and the files of its usage guide (pattern, antipattern). Use it before writing the component.",
66
+ "inputSchema": {
67
+ "type": "object",
68
+ "properties": {
69
+ "tag": {
70
+ "type": "string",
71
+ "description": "The tag, such as \"mds-button\", or the wrapper name, such as \"MdsButton\"."
72
+ }
73
+ },
74
+ "required": [
75
+ "tag"
76
+ ]
77
+ },
78
+ "outputSchema": {
79
+ "type": "object",
80
+ "properties": {
81
+ "tag": {
82
+ "type": "string"
83
+ },
84
+ "summary": {
85
+ "type": "string"
86
+ },
87
+ "props": {
88
+ "type": "array",
89
+ "items": {
90
+ "type": "object",
91
+ "properties": {
92
+ "name": {
93
+ "type": "string"
94
+ },
95
+ "attribute": {
96
+ "type": "string"
97
+ },
98
+ "type": {
99
+ "type": "string"
100
+ },
101
+ "values": {
102
+ "type": "array",
103
+ "items": {
104
+ "type": "string"
105
+ }
106
+ },
107
+ "default": {
108
+ "type": "string"
109
+ },
110
+ "required": {
111
+ "type": "boolean"
112
+ },
113
+ "description": {
114
+ "type": "string"
115
+ }
116
+ },
117
+ "required": [
118
+ "name",
119
+ "type",
120
+ "required",
121
+ "description"
122
+ ]
123
+ }
124
+ },
125
+ "events": {
126
+ "type": "array",
127
+ "items": {
128
+ "type": "object",
129
+ "properties": {
130
+ "name": {
131
+ "type": "string"
132
+ },
133
+ "detail": {
134
+ "type": "string"
135
+ },
136
+ "description": {
137
+ "type": "string"
138
+ }
139
+ },
140
+ "required": [
141
+ "name",
142
+ "detail",
143
+ "description"
144
+ ]
145
+ }
146
+ },
147
+ "methods": {
148
+ "type": "array",
149
+ "items": {
150
+ "type": "object",
151
+ "properties": {
152
+ "name": {
153
+ "type": "string"
154
+ },
155
+ "signature": {
156
+ "type": "string"
157
+ },
158
+ "description": {
159
+ "type": "string"
160
+ }
161
+ },
162
+ "required": [
163
+ "name",
164
+ "signature",
165
+ "description"
166
+ ]
167
+ }
168
+ },
169
+ "slots": {
170
+ "type": "array",
171
+ "items": {
172
+ "type": "object",
173
+ "properties": {
174
+ "name": {
175
+ "type": "string"
176
+ },
177
+ "description": {
178
+ "type": "string"
179
+ }
180
+ },
181
+ "required": [
182
+ "name",
183
+ "description"
184
+ ]
185
+ }
186
+ },
187
+ "parts": {
188
+ "type": "array",
189
+ "items": {
190
+ "type": "object",
191
+ "properties": {
192
+ "name": {
193
+ "type": "string"
194
+ },
195
+ "description": {
196
+ "type": "string"
197
+ }
198
+ },
199
+ "required": [
200
+ "name",
201
+ "description"
202
+ ]
203
+ }
204
+ },
205
+ "cssProperties": {
206
+ "type": "array",
207
+ "items": {
208
+ "type": "object",
209
+ "properties": {
210
+ "name": {
211
+ "type": "string"
212
+ },
213
+ "description": {
214
+ "type": "string"
215
+ },
216
+ "static": {
217
+ "type": "boolean",
218
+ "description": "It takes a value of its own (an illustration colour), not a token or a role."
219
+ }
220
+ },
221
+ "required": [
222
+ "name",
223
+ "description"
224
+ ]
225
+ }
226
+ },
227
+ "internalCssProperties": {
228
+ "type": "integer",
229
+ "description": "How many more it has, internal: not to be set, they may change in any release."
230
+ },
231
+ "files": {
232
+ "type": "object",
233
+ "properties": {
234
+ "api": {
235
+ "type": "string"
236
+ },
237
+ "pattern": {
238
+ "type": "string"
239
+ },
240
+ "antipattern": {
241
+ "type": "string"
242
+ }
243
+ }
244
+ }
245
+ },
246
+ "required": [
247
+ "tag",
248
+ "summary",
249
+ "props",
250
+ "events",
251
+ "methods",
252
+ "slots",
253
+ "parts",
254
+ "cssProperties",
255
+ "internalCssProperties",
256
+ "files"
257
+ ]
258
+ },
259
+ "annotations": {
260
+ "readOnlyHint": true,
261
+ "openWorldHint": false
262
+ }
263
+ },
264
+ {
265
+ "name": "get_usage",
266
+ "title": "Write a Magma component in HTML, React or Angular",
267
+ "description": "How to write one Magma component in a framework: the import, the element or wrapper name, every prop and event as that framework writes them (attribute, React prop and onMdsX handler, Angular [input] and (output)), an example and the traps of that framework.",
268
+ "inputSchema": {
269
+ "type": "object",
270
+ "properties": {
271
+ "tag": {
272
+ "type": "string",
273
+ "description": "The tag, such as \"mds-input\"."
274
+ },
275
+ "framework": {
276
+ "type": "string",
277
+ "enum": [
278
+ "html",
279
+ "react",
280
+ "angular"
281
+ ],
282
+ "description": "html (web components), react (magma-react) or angular (magma-angular)."
283
+ }
284
+ },
285
+ "required": [
286
+ "tag",
287
+ "framework"
288
+ ]
289
+ },
290
+ "outputSchema": {
291
+ "type": "object",
292
+ "properties": {
293
+ "tag": {
294
+ "type": "string"
295
+ },
296
+ "framework": {
297
+ "type": "string"
298
+ },
299
+ "import": {
300
+ "type": "string"
301
+ },
302
+ "element": {
303
+ "type": "string"
304
+ },
305
+ "props": {
306
+ "type": "array",
307
+ "items": {
308
+ "type": "object",
309
+ "properties": {
310
+ "name": {
311
+ "type": "string"
312
+ },
313
+ "written": {
314
+ "type": "string"
315
+ },
316
+ "values": {
317
+ "type": "array",
318
+ "items": {
319
+ "type": "string"
320
+ }
321
+ }
322
+ },
323
+ "required": [
324
+ "name",
325
+ "written"
326
+ ]
327
+ }
328
+ },
329
+ "events": {
330
+ "type": "array",
331
+ "items": {
332
+ "type": "object",
333
+ "properties": {
334
+ "name": {
335
+ "type": "string"
336
+ },
337
+ "written": {
338
+ "type": "string"
339
+ },
340
+ "detail": {
341
+ "type": "string"
342
+ }
343
+ },
344
+ "required": [
345
+ "name",
346
+ "written",
347
+ "detail"
348
+ ]
349
+ }
350
+ },
351
+ "example": {
352
+ "type": "string"
353
+ },
354
+ "notes": {
355
+ "type": "array",
356
+ "items": {
357
+ "type": "string"
358
+ }
359
+ }
360
+ },
361
+ "required": [
362
+ "tag",
363
+ "framework",
364
+ "import",
365
+ "element",
366
+ "props",
367
+ "events",
368
+ "example",
369
+ "notes"
370
+ ]
371
+ },
372
+ "annotations": {
373
+ "readOnlyHint": true,
374
+ "openWorldHint": false
375
+ }
376
+ },
377
+ {
378
+ "name": "list_tokens",
379
+ "title": "List Magma roles and tokens",
380
+ "description": "The Magma roles and tokens of the installed version, each with what it is for, its CSS custom property, its light value and the Tailwind class that reads it. Search them in words (\"secondary text\", \"card background\", \"radius\"). By default only the semantic roles, what UI code paints with.",
381
+ "inputSchema": {
382
+ "type": "object",
383
+ "properties": {
384
+ "query": {
385
+ "type": "string",
386
+ "description": "What the token is for, or part of its name."
387
+ },
388
+ "tier": {
389
+ "type": "string",
390
+ "enum": [
391
+ "semantic",
392
+ "primitive",
393
+ "all"
394
+ ],
395
+ "description": "semantic (default): the roles; primitive: the raw scales; all."
396
+ },
397
+ "limit": {
398
+ "type": "number",
399
+ "description": "How many to return, 30 by default."
400
+ }
401
+ }
402
+ },
403
+ "outputSchema": {
404
+ "type": "object",
405
+ "properties": {
406
+ "tokens": {
407
+ "type": "array",
408
+ "items": {
409
+ "type": "object",
410
+ "properties": {
411
+ "css": {
412
+ "type": "string"
413
+ },
414
+ "path": {
415
+ "type": "string"
416
+ },
417
+ "tier": {
418
+ "type": "string"
419
+ },
420
+ "type": {
421
+ "type": "string"
422
+ },
423
+ "description": {
424
+ "type": "string"
425
+ },
426
+ "value": {
427
+ "type": "string"
428
+ },
429
+ "classes": {
430
+ "type": "array",
431
+ "items": {
432
+ "type": "string"
433
+ }
434
+ }
435
+ },
436
+ "required": [
437
+ "path",
438
+ "tier",
439
+ "type",
440
+ "classes"
441
+ ]
442
+ }
443
+ },
444
+ "total": {
445
+ "type": "number"
446
+ },
447
+ "gap": {
448
+ "type": "string",
449
+ "description": "Set when Magma has nothing for the question: a gap to report."
450
+ }
451
+ },
452
+ "required": [
453
+ "tokens",
454
+ "total"
455
+ ]
456
+ },
457
+ "annotations": {
458
+ "readOnlyHint": true,
459
+ "openWorldHint": false
460
+ }
461
+ },
462
+ {
463
+ "name": "suggest_role",
464
+ "title": "Find the Magma role for a colour",
465
+ "description": "The semantic role to use instead of a raw colour: a literal (#f5f5f5, rgb(...), oklch(...)), a Tailwind class (bg-gray-100, text-tone-neutral-03, shadow-gray-900/20) or a palette step (--tone-neutral-09). Returns the nearest roles by their light value, for the use the class or the hint says (text, border, background, shadow; background when neither says), each with the class to write: the utility and the opacity of the class given, else the utility of the use.",
466
+ "inputSchema": {
467
+ "type": "object",
468
+ "properties": {
469
+ "color": {
470
+ "type": "string",
471
+ "description": "The colour, class or custom property to replace."
472
+ },
473
+ "use": {
474
+ "type": "string",
475
+ "enum": [
476
+ "text",
477
+ "border",
478
+ "background",
479
+ "shadow"
480
+ ],
481
+ "description": "What it paints; read from the class when there is one."
482
+ }
483
+ },
484
+ "required": [
485
+ "color"
486
+ ]
487
+ },
488
+ "outputSchema": {
489
+ "type": "object",
490
+ "properties": {
491
+ "input": {
492
+ "type": "string"
493
+ },
494
+ "use": {
495
+ "type": "string"
496
+ },
497
+ "value": {
498
+ "type": "string"
499
+ },
500
+ "roles": {
501
+ "type": "array",
502
+ "items": {
503
+ "type": "object",
504
+ "properties": {
505
+ "css": {
506
+ "type": "string"
507
+ },
508
+ "class": {
509
+ "type": "string"
510
+ },
511
+ "description": {
512
+ "type": "string"
513
+ },
514
+ "value": {
515
+ "type": "string"
516
+ },
517
+ "distance": {
518
+ "type": "number"
519
+ }
520
+ },
521
+ "required": [
522
+ "css",
523
+ "class",
524
+ "value",
525
+ "distance"
526
+ ]
527
+ }
528
+ }
529
+ },
530
+ "required": [
531
+ "input",
532
+ "use",
533
+ "value",
534
+ "roles"
535
+ ]
536
+ },
537
+ "annotations": {
538
+ "readOnlyHint": true,
539
+ "openWorldHint": false
540
+ }
541
+ },
542
+ {
543
+ "name": "explain_class",
544
+ "title": "Explain a class in Magma",
545
+ "description": "What a Tailwind class does with the Magma theme: the token it reads and its value, the Magma utility it is, or the trap it falls in (p-4 is 0.01rem in Magma, not 16px; bg-white ignores the theme). Variants, ! and opacity are read through.",
546
+ "inputSchema": {
547
+ "type": "object",
548
+ "properties": {
549
+ "class": {
550
+ "type": "string",
551
+ "description": "One class, such as \"p-4\", \"bg-surface-raised\" or \"md:text-title-h3\"."
552
+ }
553
+ },
554
+ "required": [
555
+ "class"
556
+ ]
557
+ },
558
+ "outputSchema": {
559
+ "type": "object",
560
+ "properties": {
561
+ "class": {
562
+ "type": "string"
563
+ },
564
+ "utility": {
565
+ "type": "string"
566
+ },
567
+ "kind": {
568
+ "type": "string",
569
+ "enum": [
570
+ "magma-utility",
571
+ "token",
572
+ "spacing-step",
573
+ "raw-palette",
574
+ "tailwind-palette",
575
+ "arbitrary",
576
+ "keyword",
577
+ "other"
578
+ ]
579
+ },
580
+ "description": {
581
+ "type": "string"
582
+ },
583
+ "tokens": {
584
+ "type": "array",
585
+ "items": {
586
+ "type": "object",
587
+ "properties": {
588
+ "css": {
589
+ "type": "string"
590
+ },
591
+ "value": {
592
+ "type": "string"
593
+ },
594
+ "description": {
595
+ "type": "string"
596
+ }
597
+ },
598
+ "required": [
599
+ "css"
600
+ ]
601
+ }
602
+ },
603
+ "value": {
604
+ "type": "string"
605
+ },
606
+ "suggestion": {
607
+ "type": "string"
608
+ }
609
+ },
610
+ "required": [
611
+ "class",
612
+ "utility",
613
+ "kind",
614
+ "description",
615
+ "tokens"
616
+ ]
617
+ },
618
+ "annotations": {
619
+ "readOnlyHint": true,
620
+ "openWorldHint": false
621
+ }
622
+ },
623
+ {
624
+ "name": "find_icon",
625
+ "title": "Find a Magma icon slug",
626
+ "description": "Icon slugs that exist in the sets the project installed (mi/<variant>/<name> from @material-icons/svg, mdi/<name> from @mdi/svg, mgg/<name> from svg-icons). Search by meaning (\"delete\", \"send email\"), or pass a slug to check that it exists before writing it in icon=\"...\".",
627
+ "inputSchema": {
628
+ "type": "object",
629
+ "properties": {
630
+ "query": {
631
+ "type": "string",
632
+ "description": "What the icon shows, in words."
633
+ },
634
+ "slug": {
635
+ "type": "string",
636
+ "description": "A slug to check, such as \"mi/baseline/send\"."
637
+ },
638
+ "set": {
639
+ "type": "string",
640
+ "enum": [
641
+ "mi",
642
+ "mdi",
643
+ "mgg"
644
+ ],
645
+ "description": "Search one set only."
646
+ },
647
+ "variant": {
648
+ "type": "string",
649
+ "enum": [
650
+ "baseline",
651
+ "outline",
652
+ "round",
653
+ "sharp"
654
+ ],
655
+ "description": "The Material Icons variant of the slugs found: baseline (default), outline, round, sharp."
656
+ },
657
+ "limit": {
658
+ "type": "number",
659
+ "description": "How many to return, 12 by default."
660
+ }
661
+ }
662
+ },
663
+ "outputSchema": {
664
+ "type": "object",
665
+ "properties": {
666
+ "sets": {
667
+ "type": "array",
668
+ "items": {
669
+ "type": "object",
670
+ "properties": {
671
+ "set": {
672
+ "type": "string"
673
+ },
674
+ "package": {
675
+ "type": "string"
676
+ },
677
+ "installed": {
678
+ "type": "boolean"
679
+ }
680
+ },
681
+ "required": [
682
+ "set",
683
+ "package",
684
+ "installed"
685
+ ]
686
+ }
687
+ },
688
+ "exists": {
689
+ "type": "boolean"
690
+ },
691
+ "icons": {
692
+ "type": "array",
693
+ "items": {
694
+ "type": "object",
695
+ "properties": {
696
+ "slug": {
697
+ "type": "string"
698
+ },
699
+ "set": {
700
+ "type": "string"
701
+ },
702
+ "name": {
703
+ "type": "string"
704
+ }
705
+ },
706
+ "required": [
707
+ "slug",
708
+ "set",
709
+ "name"
710
+ ]
711
+ }
712
+ },
713
+ "gap": {
714
+ "type": "string",
715
+ "description": "Set when Magma has nothing for the question: a gap to report."
716
+ }
717
+ },
718
+ "required": [
719
+ "sets",
720
+ "icons"
721
+ ]
722
+ },
723
+ "annotations": {
724
+ "readOnlyHint": true,
725
+ "openWorldHint": false
726
+ }
727
+ },
728
+ {
729
+ "name": "get_guide",
730
+ "title": "Read a Magma guide",
731
+ "description": "The guides Magma ships for agents (installation, conventions, color, typography, theming, lint...): without arguments the list with their sections, with a guide its headings, with a guide and a section the text of that section only. Read the section you need, not the whole file.",
732
+ "inputSchema": {
733
+ "type": "object",
734
+ "properties": {
735
+ "guide": {
736
+ "type": "string",
737
+ "description": "The guide, such as \"color\", \"conventions\" or \"lint\"."
738
+ },
739
+ "section": {
740
+ "type": "string",
741
+ "description": "A heading of the guide, or part of it, such as \"Boolean\"."
742
+ }
743
+ }
744
+ },
745
+ "outputSchema": {
746
+ "type": "object",
747
+ "properties": {
748
+ "guides": {
749
+ "type": "array",
750
+ "items": {
751
+ "type": "object",
752
+ "properties": {
753
+ "name": {
754
+ "type": "string"
755
+ },
756
+ "title": {
757
+ "type": "string"
758
+ },
759
+ "sections": {
760
+ "type": "array",
761
+ "items": {
762
+ "type": "string"
763
+ }
764
+ }
765
+ },
766
+ "required": [
767
+ "name",
768
+ "title",
769
+ "sections"
770
+ ]
771
+ }
772
+ },
773
+ "guide": {
774
+ "type": "string"
775
+ },
776
+ "title": {
777
+ "type": "string"
778
+ },
779
+ "sections": {
780
+ "type": "array",
781
+ "items": {
782
+ "type": "object",
783
+ "properties": {
784
+ "heading": {
785
+ "type": "string"
786
+ },
787
+ "level": {
788
+ "type": "number"
789
+ }
790
+ },
791
+ "required": [
792
+ "heading",
793
+ "level"
794
+ ]
795
+ }
796
+ },
797
+ "section": {
798
+ "type": "string"
799
+ },
800
+ "text": {
801
+ "type": "string"
802
+ }
803
+ }
804
+ },
805
+ "annotations": {
806
+ "readOnlyHint": true,
807
+ "openWorldHint": false
808
+ }
809
+ },
810
+ {
811
+ "name": "check_markup",
812
+ "title": "Check a snippet with the Magma lint",
813
+ "description": "Run the Magma lint on a snippet before writing it: prop values outside their union, \"false\" booleans, icon-only controls without a name, raw palette classes (templates and @apply), raw colours and prefers-color-scheme queries (CSS). Uses the ESLint, Stylelint and parsers the project installed; strict preset by default, so every finding is shown.",
814
+ "inputSchema": {
815
+ "type": "object",
816
+ "properties": {
817
+ "code": {
818
+ "type": "string",
819
+ "description": "The snippet."
820
+ },
821
+ "language": {
822
+ "type": "string",
823
+ "enum": [
824
+ "html",
825
+ "angular",
826
+ "jsx",
827
+ "tsx",
828
+ "css",
829
+ "scss"
830
+ ],
831
+ "description": "html, angular (an Angular template), jsx, tsx, css or scss."
832
+ },
833
+ "preset": {
834
+ "type": "string",
835
+ "enum": [
836
+ "recommended",
837
+ "strict"
838
+ ],
839
+ "description": "strict (default) or recommended, the severities of an existing product."
840
+ }
841
+ },
842
+ "required": [
843
+ "code",
844
+ "language"
845
+ ]
846
+ },
847
+ "outputSchema": {
848
+ "type": "object",
849
+ "properties": {
850
+ "language": {
851
+ "type": "string"
852
+ },
853
+ "preset": {
854
+ "type": "string"
855
+ },
856
+ "findings": {
857
+ "type": "array",
858
+ "items": {
859
+ "type": "object",
860
+ "properties": {
861
+ "rule": {
862
+ "type": "string"
863
+ },
864
+ "severity": {
865
+ "type": "string",
866
+ "enum": [
867
+ "error",
868
+ "warning"
869
+ ]
870
+ },
871
+ "message": {
872
+ "type": "string"
873
+ },
874
+ "line": {
875
+ "type": "number"
876
+ },
877
+ "column": {
878
+ "type": "number"
879
+ }
880
+ },
881
+ "required": [
882
+ "rule",
883
+ "severity",
884
+ "message",
885
+ "line",
886
+ "column"
887
+ ]
888
+ }
889
+ }
890
+ },
891
+ "required": [
892
+ "language",
893
+ "preset",
894
+ "findings"
895
+ ]
896
+ },
897
+ "annotations": {
898
+ "readOnlyHint": true,
899
+ "openWorldHint": false
900
+ }
901
+ },
902
+ {
903
+ "name": "check_setup",
904
+ "title": "Check the Magma integration of the project",
905
+ "description": "Look at the project and list what its Magma integration misses, each with the guide that fixes it: design-tokens and styles installed in the range magma depends on, the React or Angular wrapper at magma's version, the fonts of the typography, an icon set, the icon path, the lint in ESLint and Stylelint, this server in the client configuration. Read-only.",
906
+ "inputSchema": {
907
+ "type": "object",
908
+ "properties": {}
909
+ },
910
+ "outputSchema": {
911
+ "type": "object",
912
+ "properties": {
913
+ "root": {
914
+ "type": "string"
915
+ },
916
+ "magma": {
917
+ "type": "string"
918
+ },
919
+ "ok": {
920
+ "type": "boolean"
921
+ },
922
+ "checks": {
923
+ "type": "array",
924
+ "items": {
925
+ "type": "object",
926
+ "properties": {
927
+ "id": {
928
+ "type": "string"
929
+ },
930
+ "ok": {
931
+ "type": "boolean"
932
+ },
933
+ "detail": {
934
+ "type": "string"
935
+ },
936
+ "guide": {
937
+ "type": "string"
938
+ }
939
+ },
940
+ "required": [
941
+ "id",
942
+ "ok",
943
+ "detail",
944
+ "guide"
945
+ ]
946
+ }
947
+ }
948
+ },
949
+ "required": [
950
+ "root",
951
+ "magma",
952
+ "ok",
953
+ "checks"
954
+ ]
955
+ },
956
+ "annotations": {
957
+ "readOnlyHint": true,
958
+ "openWorldHint": false
959
+ }
960
+ }
961
+ ]
962
+ }