@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
@@ -4,7 +4,11 @@
4
4
  - magma/no-color-scheme-override: a hand-written @media (prefers-color-scheme), which
5
5
  follows the OS and not the mode the user picked in Magma;
6
6
  - magma/no-internal-tokens: an `--mds-*` custom property set or read that no component
7
- promises: internal ones may change in any release.
7
+ promises, in a declaration or in a class of `@apply`: internal ones may change in any
8
+ release;
9
+ - magma/no-raw-palette-classes: a class of `@apply` that paints with Tailwind's palette or
10
+ a raw Magma step, the check of the ESLint rule of the same name on the classes a sheet
11
+ applies, as no-internal-tokens is.
8
12
 
9
13
  // stylelint.config.mjs
10
14
  export default { extends: ['@maggioli-design-system/magma/stylelint/recommended'] };
@@ -14,16 +18,25 @@
14
18
  the public custom properties marked static, which take a value of their own (the colours
15
19
  of an illustration), not a role.
16
20
 
17
- The rules that read the installed documentation.json find it beside them, inside magma;
18
- their secondary options `root` and `documentation` point elsewhere, as `settings.magma`
21
+ The rules that read the installed documentation.json find it beside them, inside magma,
22
+ and the palette rule resolves design-tokens and styles from there; their secondary options
23
+ `root`, `documentation`, `tokens` and `consumption` point elsewhere, as `settings.magma`
19
24
  does for the ESLint plugin.
20
25
  */
21
26
  import stylelint from 'stylelint';
22
27
  import { colorLiterals } from '../core/colors.js';
23
- import { internalTokenMessage } from '../core/checks.js';
24
- import { loadStyles } from '../core/data.js';
28
+ import { internalTokenMessage, rawPaletteMessage, utilityOf } from '../core/checks.js';
29
+ import { customPropertiesOf } from '../core/element.js';
30
+ import { lintGuideUrl, loadPalette, loadStyles, } from '../core/data.js';
25
31
  const { createPlugin, utils: { report, ruleMessages, validateOptions }, } = stylelint;
26
- const DOCS = 'https://github.com/magma-design-system/magma/blob/main/docs/agents/lint.md';
32
+ /**
33
+ * The meta of a rule: the section of the guide at the installed release and, as the ESLint
34
+ * rules have in meta.docs, what the rule asks for. Stylelint's own meta has no description.
35
+ */
36
+ const metaOf = (name, description) => ({
37
+ url: lintGuideUrl(name),
38
+ description,
39
+ });
27
40
  const isString = (value) => typeof value === 'string';
28
41
  /** The secondary options that point the data elsewhere (core/data.ts). */
29
42
  const DATA_OPTIONS = { root: [isString], documentation: [isString] };
@@ -37,6 +50,22 @@ const stylesOf = (secondary) => {
37
50
  return undefined;
38
51
  }
39
52
  };
53
+ /** The secondary options of the palette rule: the files of loadPalette. */
54
+ const PALETTE_OPTIONS = { root: [isString], tokens: [isString], consumption: [isString] };
55
+ /** The palette of the installed version, or undefined when its tokens or consumption map cannot be found. */
56
+ const paletteOf = (secondary) => {
57
+ const { root, tokens, consumption } = (secondary ?? {});
58
+ try {
59
+ return loadPalette({
60
+ ...(root ? { root } : {}),
61
+ ...(tokens ? { tokens } : {}),
62
+ ...(consumption ? { consumption } : {}),
63
+ });
64
+ }
65
+ catch {
66
+ return undefined;
67
+ }
68
+ };
40
69
  const COMPONENT_VAR = /--mds-[\w-]+/g;
41
70
  /** A mask paints with the alpha of its image: black and white there are not colours. */
42
71
  const MASK = /^(?:-webkit-)?mask(?:-image)?$/i;
@@ -76,7 +105,7 @@ const noRawColor = (primary, secondary) => (root, result) => {
76
105
  };
77
106
  noRawColor.ruleName = noRawColorName;
78
107
  noRawColor.messages = noRawColorMessages;
79
- noRawColor.meta = { url: `${DOCS}#no-raw-color` };
108
+ noRawColor.meta = metaOf('no-raw-color', 'A stylesheet paints with a role, rgb(var(--magma-*)), not with a colour literal (hex, rgb(), hsl() and the other colour functions).');
80
109
  const noColorSchemeName = 'magma/no-color-scheme-override';
81
110
  const noColorSchemeMessages = ruleMessages(noColorSchemeName, {
82
111
  rejected: () => 'Unexpected prefers-color-scheme query: it follows the OS, not the mode the user picked in Magma (mds-pref-mode). The roles, rgb(var(--magma-*)), already follow both: paint with them; for a deliberate choice that differs per mode, use the dark variant of the Magma Tailwind theme (dark:, @variant dark), which follows the Magma mode (agents/theming.md)',
@@ -97,7 +126,7 @@ const noColorSchemeOverride = (primary) => (root, result) => {
97
126
  };
98
127
  noColorSchemeOverride.ruleName = noColorSchemeName;
99
128
  noColorSchemeOverride.messages = noColorSchemeMessages;
100
- noColorSchemeOverride.meta = { url: `${DOCS}#no-color-scheme-override` };
129
+ noColorSchemeOverride.meta = metaOf('no-color-scheme-override', 'A stylesheet follows the mode the user picked in Magma, not the OS: no prefers-color-scheme query.');
101
130
  const noInternalTokensName = 'magma/no-internal-tokens';
102
131
  const noInternalTokensMessages = ruleMessages(noInternalTokensName, {
103
132
  rejected: (message) => message,
@@ -109,29 +138,66 @@ const noInternalTokens = (primary, secondary) => (root, result) => {
109
138
  // without the documentation of the installed version there is nothing to hold the names to
110
139
  if (!styles)
111
140
  return;
112
- root.walkDecls((decl) => {
113
- const names = new Set(decl.value.match(COMPONENT_VAR) ?? []);
114
- if (decl.prop.startsWith('--mds-'))
115
- names.add(decl.prop);
141
+ const check = (node, names) => {
116
142
  for (const name of names) {
117
143
  const message = internalTokenMessage(name, styles.get(name));
118
144
  if (message)
119
145
  report({
120
146
  ruleName: noInternalTokensName,
121
147
  result,
122
- node: decl,
148
+ node,
123
149
  word: name,
124
150
  message: noInternalTokensMessages.rejected(message),
125
151
  });
126
152
  }
153
+ };
154
+ root.walkDecls((decl) => {
155
+ const names = new Set(decl.value.match(COMPONENT_VAR) ?? []);
156
+ if (decl.prop.startsWith('--mds-'))
157
+ names.add(decl.prop);
158
+ check(decl, names);
127
159
  });
160
+ // the classes a sheet applies, as the templates write them: `@apply [--mds-x:red]`
161
+ root.walkAtRules('apply', (rule) => check(rule, new Set(rule.params
162
+ .split(/\s+/)
163
+ .flatMap((name) => customPropertiesOf(utilityOf(name), rule).map((one) => one.name)))));
128
164
  };
129
165
  noInternalTokens.ruleName = noInternalTokensName;
130
166
  noInternalTokens.messages = noInternalTokensMessages;
131
- noInternalTokens.meta = { url: `${DOCS}#no-internal-tokens` };
167
+ noInternalTokens.meta = metaOf('no-internal-tokens', 'A declaration or a class of @apply sets or reads only the custom properties a Magma component promises.');
168
+ const noRawPaletteClassesName = 'magma/no-raw-palette-classes';
169
+ const noRawPaletteClassesMessages = ruleMessages(noRawPaletteClassesName, {
170
+ rejected: (message) => message,
171
+ });
172
+ const noRawPaletteClasses = (primary, secondary) => (root, result) => {
173
+ if (!validateOptions(result, noRawPaletteClassesName, { actual: primary }, { actual: secondary, possible: PALETTE_OPTIONS, optional: true }))
174
+ return;
175
+ const palette = paletteOf(secondary);
176
+ // without the tokens of the installed version there is nothing to tell a raw step from a role
177
+ if (!palette)
178
+ return;
179
+ // the classes a sheet applies, as the templates write them; the codemod migrates them too
180
+ root.walkAtRules('apply', (rule) => {
181
+ for (const name of rule.params.split(/\s+/).filter(Boolean)) {
182
+ const message = rawPaletteMessage(name, palette);
183
+ if (message)
184
+ report({
185
+ ruleName: noRawPaletteClassesName,
186
+ result,
187
+ node: rule,
188
+ word: name,
189
+ message: noRawPaletteClassesMessages.rejected(message),
190
+ });
191
+ }
192
+ });
193
+ };
194
+ noRawPaletteClasses.ruleName = noRawPaletteClassesName;
195
+ noRawPaletteClasses.messages = noRawPaletteClassesMessages;
196
+ noRawPaletteClasses.meta = metaOf('no-raw-palette-classes', "A class of @apply names a role, not Tailwind's palette or a raw Magma step.");
132
197
  const plugins = [
133
198
  createPlugin(noRawColorName, noRawColor),
134
199
  createPlugin(noColorSchemeName, noColorSchemeOverride),
135
200
  createPlugin(noInternalTokensName, noInternalTokens),
201
+ createPlugin(noRawPaletteClassesName, noRawPaletteClasses),
136
202
  ];
137
203
  export default plugins;
@@ -5,6 +5,7 @@ const config = {
5
5
  'magma/no-color-scheme-override': true,
6
6
  'magma/no-internal-tokens': [true, { severity: 'warning' }],
7
7
  'magma/no-raw-color': [true, { severity: 'warning' }],
8
+ 'magma/no-raw-palette-classes': [true, { severity: 'warning' }],
8
9
  },
9
10
  };
10
11
  export default config;
@@ -5,6 +5,7 @@ const config = {
5
5
  'magma/no-color-scheme-override': true,
6
6
  'magma/no-internal-tokens': true,
7
7
  'magma/no-raw-color': true,
8
+ 'magma/no-raw-palette-classes': true,
8
9
  },
9
10
  };
10
11
  export default config;
package/dist/stats.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-24T12:14:49",
2
+ "timestamp": "2026-10-24T18:40:20",
3
3
  "compiler": {
4
4
  "name": "node",
5
5
  "version": "24.14.0"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@maggioli-design-system/magma",
3
- "version": "2.6.0",
3
+ "version": "2.7.0",
4
4
  "description": "Magma is Maggioli Design System's web-components library.",
5
5
  "main": "dist/index.cjs.js",
6
6
  "module": "dist/index.js",
@@ -78,6 +78,7 @@
78
78
  "./agents/*": "./agents/*",
79
79
  "./CHANGELOG.md": "./CHANGELOG.md",
80
80
  "./dist/documentation.json": "./dist/documentation.json",
81
+ "./dist/lint/mcp/tools.json": "./dist/lint/mcp/tools.json",
81
82
  "./dist/collection/components/*.md": "./dist/collection/components/*.md",
82
83
  "./dist/collection/components/*/documentation.json": "./dist/collection/components/*/documentation.json",
83
84
  "./package.json": "./package.json"