igniteui-theming 25.1.0 → 25.2.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 (128) hide show
  1. package/dist/index.d.ts +75 -0
  2. package/dist/index.js +12 -0
  3. package/dist/json/components/bootstrap.json +1 -0
  4. package/dist/json/components/fluent.json +1 -0
  5. package/dist/json/components/indigo.json +1 -0
  6. package/dist/json/components/material.json +1 -0
  7. package/{json → dist/json}/components/themes.json +31 -1
  8. package/dist/mcp/generators/css.d.ts +7 -4
  9. package/dist/mcp/generators/css.js +129 -104
  10. package/dist/mcp/generators/sass.js +227 -254
  11. package/dist/mcp/index.js +259 -323
  12. package/dist/mcp/knowledge/color-usage.js +524 -502
  13. package/dist/mcp/knowledge/colors.js +61 -50
  14. package/dist/mcp/knowledge/component-metadata.js +697 -598
  15. package/dist/mcp/knowledge/component-themes.js +70 -57
  16. package/dist/mcp/knowledge/custom-palettes.js +4 -9
  17. package/dist/mcp/knowledge/docs/colors/guidance.js +4 -0
  18. package/dist/mcp/knowledge/docs/colors/usage.js +4 -0
  19. package/dist/mcp/knowledge/docs/layout/functions/border-radius.js +4 -0
  20. package/dist/mcp/knowledge/docs/layout/functions/pad.js +4 -0
  21. package/dist/mcp/knowledge/docs/layout/functions/sizable.js +4 -0
  22. package/dist/mcp/knowledge/docs/layout/mixins/sizable.js +4 -0
  23. package/dist/mcp/knowledge/docs/layout/mixins/sizing.js +4 -0
  24. package/dist/mcp/knowledge/docs/layout/mixins/spacing.js +4 -0
  25. package/dist/mcp/knowledge/docs/layout/overview.js +4 -0
  26. package/dist/mcp/knowledge/docs/setup/platform.js +4 -0
  27. package/dist/mcp/knowledge/elevations.d.ts +1 -1
  28. package/dist/mcp/knowledge/elevations.js +26 -12
  29. package/dist/mcp/knowledge/index.js +23 -87
  30. package/dist/mcp/knowledge/layout-docs.d.ts +1 -1
  31. package/dist/mcp/knowledge/multipliers.js +5 -0
  32. package/dist/mcp/knowledge/palettes.js +29 -17
  33. package/dist/mcp/knowledge/platforms/angular.js +98 -120
  34. package/dist/mcp/knowledge/platforms/blazor.js +39 -34
  35. package/dist/mcp/knowledge/platforms/common.js +83 -68
  36. package/dist/mcp/knowledge/platforms/index.js +265 -242
  37. package/dist/mcp/knowledge/platforms/react.js +43 -35
  38. package/dist/mcp/knowledge/platforms/webcomponents.js +266 -292
  39. package/dist/mcp/knowledge/sass-api.js +1 -0
  40. package/dist/mcp/knowledge/typography.js +13 -5
  41. package/dist/mcp/resources/index.js +1 -0
  42. package/dist/mcp/resources/presets.js +409 -508
  43. package/dist/mcp/theming/dist/json/colors/meta/multipliers.js +50 -0
  44. package/dist/mcp/theming/dist/json/colors/presets/palettes.js +85 -0
  45. package/dist/mcp/theming/dist/json/components/themes.js +5792 -0
  46. package/dist/mcp/theming/dist/json/elevations/indigo.js +29 -0
  47. package/dist/mcp/theming/dist/json/elevations/material.js +3 -0
  48. package/dist/mcp/theming/dist/json/typography/presets/typescales.js +621 -0
  49. package/dist/mcp/tools/descriptions.js +98 -154
  50. package/dist/mcp/tools/handlers/color.js +58 -56
  51. package/dist/mcp/tools/handlers/component-theme.js +163 -225
  52. package/dist/mcp/tools/handlers/component-tokens.js +159 -219
  53. package/dist/mcp/tools/handlers/custom-palette.js +138 -179
  54. package/dist/mcp/tools/handlers/elevations.js +27 -28
  55. package/dist/mcp/tools/handlers/index.js +11 -0
  56. package/dist/mcp/tools/handlers/layout.js +125 -176
  57. package/dist/mcp/tools/handlers/palette.js +105 -120
  58. package/dist/mcp/tools/handlers/platform.js +289 -311
  59. package/dist/mcp/tools/handlers/resource.js +22 -31
  60. package/dist/mcp/tools/handlers/theme.js +86 -103
  61. package/dist/mcp/tools/handlers/typography.js +29 -30
  62. package/dist/mcp/tools/index.js +13 -0
  63. package/dist/mcp/tools/schemas.js +239 -218
  64. package/dist/mcp/utils/color.js +277 -239
  65. package/dist/mcp/utils/preprocessing.js +57 -30
  66. package/dist/mcp/utils/result.js +43 -45
  67. package/dist/mcp/utils/sass.js +271 -191
  68. package/dist/mcp/utils/theming-resolve.d.ts +19 -0
  69. package/dist/mcp/utils/theming-resolve.js +57 -0
  70. package/dist/mcp/utils/types.js +96 -53
  71. package/dist/mcp/validators/custom-palette.js +218 -243
  72. package/dist/mcp/validators/index.js +3 -0
  73. package/dist/mcp/validators/palette.js +231 -229
  74. package/dist/tailwind/utilities/bootstrap.css +1 -0
  75. package/dist/tailwind/utilities/fluent.css +1 -0
  76. package/dist/tailwind/utilities/indigo.css +1 -0
  77. package/dist/tailwind/utilities/material.css +1 -0
  78. package/package.json +45 -64
  79. package/sass/json/README.md +12 -7
  80. package/sass/themes/_mixins.scss +1 -0
  81. package/sass/themes/components/button-group/_button-group-theme.scss +42 -0
  82. package/sass/themes/components/grid/_grid-theme.scss +1 -1
  83. package/sass/themes/schemas/components/dark/_button-group.scss +173 -50
  84. package/sass/themes/schemas/components/dark/_grid.scss +0 -16
  85. package/sass/themes/schemas/components/light/_button-group.scss +221 -99
  86. package/sass/themes/schemas/components/light/_grid.scss +14 -20
  87. package/LICENSE +0 -21
  88. package/README.md +0 -391
  89. package/dist/mcp/json/colors/presets/palettes.json.js +0 -13
  90. package/dist/mcp/json/components/themes.json.js +0 -143
  91. package/dist/mcp/json/elevations/indigo.json.js +0 -8
  92. package/dist/mcp/json/elevations/material.json.js +0 -8
  93. package/dist/mcp/json/typography/presets/typescales.json.js +0 -17
  94. package/dist/mcp/knowledge/docs/colors/guidance.md.js +0 -4
  95. package/dist/mcp/knowledge/docs/colors/usage.md.js +0 -4
  96. package/dist/mcp/knowledge/docs/layout/functions/border-radius.md.js +0 -4
  97. package/dist/mcp/knowledge/docs/layout/functions/pad.md.js +0 -4
  98. package/dist/mcp/knowledge/docs/layout/functions/sizable.md.js +0 -4
  99. package/dist/mcp/knowledge/docs/layout/mixins/sizable.md.js +0 -4
  100. package/dist/mcp/knowledge/docs/layout/mixins/sizing.md.js +0 -4
  101. package/dist/mcp/knowledge/docs/layout/mixins/spacing.md.js +0 -4
  102. package/dist/mcp/knowledge/docs/layout/overview.md.js +0 -4
  103. package/dist/mcp/knowledge/docs/setup/platform.md.js +0 -4
  104. package/dist/mcp/vite-env.d.ts +0 -18
  105. package/index.js +0 -5
  106. package/json/components/bootstrap.json +0 -1
  107. package/json/components/fluent.json +0 -1
  108. package/json/components/indigo.json +0 -1
  109. package/json/components/material.json +0 -1
  110. package/tailwind/utilities/bootstrap.css +0 -1
  111. package/tailwind/utilities/fluent.css +0 -1
  112. package/tailwind/utilities/indigo.css +0 -1
  113. package/tailwind/utilities/material.css +0 -1
  114. /package/{json → dist/json}/colors/meta/multipliers.json +0 -0
  115. /package/{json → dist/json}/colors/meta/palette.json +0 -0
  116. /package/{json → dist/json}/colors/presets/palettes.json +0 -0
  117. /package/{json → dist/json}/elevations/indigo.json +0 -0
  118. /package/{json → dist/json}/elevations/material.json +0 -0
  119. /package/{json → dist/json}/typography/presets/typescales.json +0 -0
  120. /package/{tailwind → dist/tailwind}/themes/base.css +0 -0
  121. /package/{tailwind → dist/tailwind}/themes/dark/bootstrap.css +0 -0
  122. /package/{tailwind → dist/tailwind}/themes/dark/fluent.css +0 -0
  123. /package/{tailwind → dist/tailwind}/themes/dark/indigo.css +0 -0
  124. /package/{tailwind → dist/tailwind}/themes/dark/material.css +0 -0
  125. /package/{tailwind → dist/tailwind}/themes/light/bootstrap.css +0 -0
  126. /package/{tailwind → dist/tailwind}/themes/light/fluent.css +0 -0
  127. /package/{tailwind → dist/tailwind}/themes/light/indigo.css +0 -0
  128. /package/{tailwind → dist/tailwind}/themes/light/material.css +0 -0
@@ -1,52 +1,63 @@
1
- import { SUGGESTED_COLORS, LUMINANCE_THRESHOLD, DEFAULT_MINIMUM_CONTRAST_RATIO } from "../utils/color.js";
2
- const COLOR_VARIANT_RULES = {
3
- light: {
4
- description: "Light theme variant with light backgrounds and dark text",
5
- surface: {
6
- requirement: "light",
7
- luminanceRule: `luminance > ${LUMINANCE_THRESHOLD}`,
8
- explanation: "Light themes use bright backgrounds (white, off-white, light gray)",
9
- examples: SUGGESTED_COLORS.light.surface
10
- },
11
- gray: {
12
- requirement: "dark",
13
- luminanceRule: `luminance <= ${LUMINANCE_THRESHOLD}`,
14
- explanation: "Gray base should be dark so the generated gray shades contrast well against light surfaces",
15
- examples: SUGGESTED_COLORS.light.gray
16
- }
17
- },
18
- dark: {
19
- description: "Dark theme variant with dark backgrounds and light text",
20
- surface: {
21
- requirement: "dark",
22
- luminanceRule: `luminance <= ${LUMINANCE_THRESHOLD}`,
23
- explanation: "Dark themes use dark backgrounds (near-black, dark gray)",
24
- examples: SUGGESTED_COLORS.dark.surface
25
- },
26
- gray: {
27
- requirement: "light",
28
- luminanceRule: `luminance > ${LUMINANCE_THRESHOLD}`,
29
- explanation: "Gray base should be light so the generated gray shades contrast well against dark surfaces",
30
- examples: SUGGESTED_COLORS.dark.gray
31
- }
32
- }
1
+ import { LUMINANCE_THRESHOLD, SUGGESTED_COLORS } from "../utils/color.js";
2
+ import "./docs/colors/guidance.js";
3
+ //#region src/knowledge/colors.ts
4
+ /**
5
+ * Color rules and guidance documentation for AI context.
6
+ * This knowledge helps AI models understand the relationship between
7
+ * theme variants and color choices.
8
+ */
9
+ /**
10
+ * Color variant rules for surface and gray colors.
11
+ */
12
+ var COLOR_VARIANT_RULES = {
13
+ light: {
14
+ description: "Light theme variant with light backgrounds and dark text",
15
+ surface: {
16
+ requirement: "light",
17
+ luminanceRule: `luminance > ${LUMINANCE_THRESHOLD}`,
18
+ explanation: "Light themes use bright backgrounds (white, off-white, light gray)",
19
+ examples: SUGGESTED_COLORS.light.surface
20
+ },
21
+ gray: {
22
+ requirement: "dark",
23
+ luminanceRule: `luminance <= ${LUMINANCE_THRESHOLD}`,
24
+ explanation: "Gray base should be dark so the generated gray shades contrast well against light surfaces",
25
+ examples: SUGGESTED_COLORS.light.gray
26
+ }
27
+ },
28
+ dark: {
29
+ description: "Dark theme variant with dark backgrounds and light text",
30
+ surface: {
31
+ requirement: "dark",
32
+ luminanceRule: `luminance <= ${LUMINANCE_THRESHOLD}`,
33
+ explanation: "Dark themes use dark backgrounds (near-black, dark gray)",
34
+ examples: SUGGESTED_COLORS.dark.surface
35
+ },
36
+ gray: {
37
+ requirement: "light",
38
+ luminanceRule: `luminance > ${LUMINANCE_THRESHOLD}`,
39
+ explanation: "Gray base should be light so the generated gray shades contrast well against dark surfaces",
40
+ examples: SUGGESTED_COLORS.dark.gray
41
+ }
42
+ }
33
43
  };
34
- const COLOR_RULES_SUMMARY = {
35
- luminanceThreshold: LUMINANCE_THRESHOLD,
36
- minimumContrastRatio: DEFAULT_MINIMUM_CONTRAST_RATIO,
37
- rules: {
38
- light: {
39
- surface: `luminance > ${LUMINANCE_THRESHOLD} (light color)`,
40
- gray: `luminance <= ${LUMINANCE_THRESHOLD} (dark color)`
41
- },
42
- dark: {
43
- surface: `luminance <= ${LUMINANCE_THRESHOLD} (dark color)`,
44
- gray: `luminance > ${LUMINANCE_THRESHOLD} (light color)`
45
- }
46
- },
47
- suggestedColors: SUGGESTED_COLORS
48
- };
49
- export {
50
- COLOR_RULES_SUMMARY,
51
- COLOR_VARIANT_RULES
44
+ /**
45
+ * Compact rules for quick reference.
46
+ */
47
+ var COLOR_RULES_SUMMARY = {
48
+ luminanceThreshold: LUMINANCE_THRESHOLD,
49
+ minimumContrastRatio: 3,
50
+ rules: {
51
+ light: {
52
+ surface: `luminance > ${LUMINANCE_THRESHOLD} (light color)`,
53
+ gray: `luminance <= ${LUMINANCE_THRESHOLD} (dark color)`
54
+ },
55
+ dark: {
56
+ surface: `luminance <= ${LUMINANCE_THRESHOLD} (dark color)`,
57
+ gray: `luminance > ${LUMINANCE_THRESHOLD} (light color)`
58
+ }
59
+ },
60
+ suggestedColors: SUGGESTED_COLORS
52
61
  };
62
+ //#endregion
63
+ export { COLOR_RULES_SUMMARY, COLOR_VARIANT_RULES };