@trishchuk/coolors-mcp 1.0.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 (197) hide show
  1. package/.claude/settings.local.json +39 -0
  2. package/.env +2 -0
  3. package/.github/ISSUE_TEMPLATE/bug_report.md +73 -0
  4. package/.github/ISSUE_TEMPLATE/feature_request.md +71 -0
  5. package/.github/pull_request_template.md +97 -0
  6. package/.github/workflows/ci.yml +127 -0
  7. package/.github/workflows/deploy-docs.yml +56 -0
  8. package/.github/workflows/release.yml +99 -0
  9. package/.mcp.json +12 -0
  10. package/.prettierignore +1 -0
  11. package/CLAUDE.md +201 -0
  12. package/DOCUMENTATION.md +274 -0
  13. package/GEMINI.md +54 -0
  14. package/LICENSE +21 -0
  15. package/README.md +401 -0
  16. package/demo/content_based_color.png +0 -0
  17. package/demo/music-player.html +621 -0
  18. package/demo/podcast-player.html +903 -0
  19. package/dist/bin/coolors-mcp.d.ts +1 -0
  20. package/dist/bin/coolors-mcp.js +154 -0
  21. package/dist/bin/coolors-mcp.js.map +1 -0
  22. package/dist/bin/server.d.ts +1 -0
  23. package/dist/bin/server.js +3292 -0
  24. package/dist/bin/server.js.map +1 -0
  25. package/dist/chunk-IQ7NN26V.js +114 -0
  26. package/dist/chunk-IQ7NN26V.js.map +1 -0
  27. package/dist/chunk-P3ARRKLS.js +1214 -0
  28. package/dist/chunk-P3ARRKLS.js.map +1 -0
  29. package/dist/color/index.d.ts +716 -0
  30. package/dist/color/index.js +153 -0
  31. package/dist/color/index.js.map +1 -0
  32. package/dist/coolors-mcp.d.ts +136 -0
  33. package/dist/coolors-mcp.js +7 -0
  34. package/dist/coolors-mcp.js.map +1 -0
  35. package/docs/.vitepress/cache/deps/@braintree_sanitize-url.js +93 -0
  36. package/docs/.vitepress/cache/deps/@braintree_sanitize-url.js.map +7 -0
  37. package/docs/.vitepress/cache/deps/_metadata.json +127 -0
  38. package/docs/.vitepress/cache/deps/chunk-BUSYA2B4.js +9 -0
  39. package/docs/.vitepress/cache/deps/chunk-BUSYA2B4.js.map +7 -0
  40. package/docs/.vitepress/cache/deps/chunk-JD3CXNQ6.js +12683 -0
  41. package/docs/.vitepress/cache/deps/chunk-JD3CXNQ6.js.map +7 -0
  42. package/docs/.vitepress/cache/deps/chunk-SYPOPCWC.js +9719 -0
  43. package/docs/.vitepress/cache/deps/chunk-SYPOPCWC.js.map +7 -0
  44. package/docs/.vitepress/cache/deps/cytoscape-cose-bilkent.js +4710 -0
  45. package/docs/.vitepress/cache/deps/cytoscape-cose-bilkent.js.map +7 -0
  46. package/docs/.vitepress/cache/deps/cytoscape.js +30278 -0
  47. package/docs/.vitepress/cache/deps/cytoscape.js.map +7 -0
  48. package/docs/.vitepress/cache/deps/dayjs.js +285 -0
  49. package/docs/.vitepress/cache/deps/dayjs.js.map +7 -0
  50. package/docs/.vitepress/cache/deps/debug.js +468 -0
  51. package/docs/.vitepress/cache/deps/debug.js.map +7 -0
  52. package/docs/.vitepress/cache/deps/package.json +3 -0
  53. package/docs/.vitepress/cache/deps/prismjs.js +1466 -0
  54. package/docs/.vitepress/cache/deps/prismjs.js.map +7 -0
  55. package/docs/.vitepress/cache/deps/prismjs_components_prism-bash.js +228 -0
  56. package/docs/.vitepress/cache/deps/prismjs_components_prism-bash.js.map +7 -0
  57. package/docs/.vitepress/cache/deps/prismjs_components_prism-javascript.js +142 -0
  58. package/docs/.vitepress/cache/deps/prismjs_components_prism-javascript.js.map +7 -0
  59. package/docs/.vitepress/cache/deps/prismjs_components_prism-json.js +27 -0
  60. package/docs/.vitepress/cache/deps/prismjs_components_prism-json.js.map +7 -0
  61. package/docs/.vitepress/cache/deps/prismjs_components_prism-python.js +65 -0
  62. package/docs/.vitepress/cache/deps/prismjs_components_prism-python.js.map +7 -0
  63. package/docs/.vitepress/cache/deps/prismjs_components_prism-typescript.js +53 -0
  64. package/docs/.vitepress/cache/deps/prismjs_components_prism-typescript.js.map +7 -0
  65. package/docs/.vitepress/cache/deps/prismjs_components_prism-yaml.js +73 -0
  66. package/docs/.vitepress/cache/deps/prismjs_components_prism-yaml.js.map +7 -0
  67. package/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js +4507 -0
  68. package/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js.map +7 -0
  69. package/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js +584 -0
  70. package/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js.map +7 -0
  71. package/docs/.vitepress/cache/deps/vitepress___@vueuse_integrations_useFocusTrap.js +1146 -0
  72. package/docs/.vitepress/cache/deps/vitepress___@vueuse_integrations_useFocusTrap.js.map +7 -0
  73. package/docs/.vitepress/cache/deps/vitepress___mark__js_src_vanilla__js.js +1667 -0
  74. package/docs/.vitepress/cache/deps/vitepress___mark__js_src_vanilla__js.js.map +7 -0
  75. package/docs/.vitepress/cache/deps/vitepress___minisearch.js +1814 -0
  76. package/docs/.vitepress/cache/deps/vitepress___minisearch.js.map +7 -0
  77. package/docs/.vitepress/cache/deps/vue.js +344 -0
  78. package/docs/.vitepress/cache/deps/vue.js.map +7 -0
  79. package/docs/.vitepress/components/ClientGrid.vue +125 -0
  80. package/docs/.vitepress/components/CodeBlock.vue +231 -0
  81. package/docs/.vitepress/components/ConfigModal.vue +477 -0
  82. package/docs/.vitepress/components/DiagramModal.vue +528 -0
  83. package/docs/.vitepress/components/TroubleshootingModal.vue +472 -0
  84. package/docs/.vitepress/config.js +162 -0
  85. package/docs/.vitepress/theme/FundingLayout.vue +251 -0
  86. package/docs/.vitepress/theme/Layout.vue +134 -0
  87. package/docs/.vitepress/theme/components/AdBanner.vue +317 -0
  88. package/docs/.vitepress/theme/components/AdPlaceholder.vue +78 -0
  89. package/docs/.vitepress/theme/components/FundingEffects.vue +322 -0
  90. package/docs/.vitepress/theme/components/FundingHero.vue +345 -0
  91. package/docs/.vitepress/theme/components/SupportSection.vue +511 -0
  92. package/docs/.vitepress/theme/custom-app.css +339 -0
  93. package/docs/.vitepress/theme/custom.css +699 -0
  94. package/docs/.vitepress/theme/index.js +25 -0
  95. package/docs/README.md +198 -0
  96. package/docs/concepts/accessibility.md +473 -0
  97. package/docs/concepts/color-spaces.md +222 -0
  98. package/docs/concepts/distance-metrics.md +384 -0
  99. package/docs/concepts/hct.md +261 -0
  100. package/docs/concepts/image-analysis.md +396 -0
  101. package/docs/concepts/material-design.md +306 -0
  102. package/docs/concepts/theme-matching.md +399 -0
  103. package/docs/examples/basic-colors.md +490 -0
  104. package/docs/examples/creating-themes.md +898 -0
  105. package/docs/examples/css-refactoring.md +824 -0
  106. package/docs/examples/image-extraction.md +882 -0
  107. package/docs/getting-started.md +366 -0
  108. package/docs/index.md +190 -0
  109. package/docs/installation.md +157 -0
  110. package/docs/tools/README.md +234 -0
  111. package/docs/tools/accessibility.md +614 -0
  112. package/docs/tools/color-operations.md +374 -0
  113. package/docs/tools/image-extraction.md +624 -0
  114. package/docs/tools/material-design.md +347 -0
  115. package/docs/tools/theme-matching.md +552 -0
  116. package/eslint.config.ts +14 -0
  117. package/examples/theme-matching.md +113 -0
  118. package/jsr.json +7 -0
  119. package/mcp-config.json +8 -0
  120. package/note.md +35 -0
  121. package/package.json +122 -0
  122. package/research_results.md +53 -0
  123. package/src/bin/coolors-mcp.ts +194 -0
  124. package/src/bin/server.ts +61 -0
  125. package/src/color/__tests__/conversions-argb.test.ts +198 -0
  126. package/src/color/__tests__/extract-colors.test.ts +360 -0
  127. package/src/color/__tests__/image-utils.test.ts +242 -0
  128. package/src/color/__tests__/reference-colors.test.ts +278 -0
  129. package/src/color/__tests__/round-trip.test.ts +197 -0
  130. package/src/color/conversions.test.ts +402 -0
  131. package/src/color/conversions.ts +393 -0
  132. package/src/color/dislike/__tests__/dislike-analyzer.test.ts +248 -0
  133. package/src/color/dislike/dislike-analyzer.ts +114 -0
  134. package/src/color/extract-colors.ts +228 -0
  135. package/src/color/hct/__tests__/hct-class.test.ts +232 -0
  136. package/src/color/hct/harmonization.ts +204 -0
  137. package/src/color/hct/hct-class.ts +109 -0
  138. package/src/color/hct/hct-solver.ts +168 -0
  139. package/src/color/hct/index.ts +39 -0
  140. package/src/color/hct/tonal-palette.ts +211 -0
  141. package/src/color/hct/types.ts +88 -0
  142. package/src/color/image-utils.ts +79 -0
  143. package/src/color/index.ts +87 -0
  144. package/src/color/material-theme.ts +157 -0
  145. package/src/color/metrics.test.ts +276 -0
  146. package/src/color/metrics.ts +281 -0
  147. package/src/color/quantize/__tests__/quantizer_celebi.test.ts +195 -0
  148. package/src/color/quantize/lab_point_provider.ts +55 -0
  149. package/src/color/quantize/point_provider.ts +27 -0
  150. package/src/color/quantize/quantizer_celebi.ts +51 -0
  151. package/src/color/quantize/quantizer_celebi_test.ts +71 -0
  152. package/src/color/quantize/quantizer_map.ts +47 -0
  153. package/src/color/quantize/quantizer_wsmeans.ts +232 -0
  154. package/src/color/quantize/quantizer_wu.ts +472 -0
  155. package/src/color/score/__tests__/score.test.ts +224 -0
  156. package/src/color/score/score.ts +175 -0
  157. package/src/color/types.ts +151 -0
  158. package/src/color/utils/color_utils.ts +292 -0
  159. package/src/color/utils/math_utils.ts +145 -0
  160. package/src/color/utils.test.ts +403 -0
  161. package/src/color/utils.ts +315 -0
  162. package/src/constants.ts +5 -0
  163. package/src/coolors-mcp.ts +37 -0
  164. package/src/examples/addition.ts +333 -0
  165. package/src/examples/color-demo.ts +125 -0
  166. package/src/examples/custom-logger.ts +201 -0
  167. package/src/examples/oauth-server.ts +113 -0
  168. package/src/examples/session-context.ts +269 -0
  169. package/src/session.ts +116 -0
  170. package/src/theme/__tests__/matcher.test.ts +180 -0
  171. package/src/theme/__tests__/parser.test.ts +148 -0
  172. package/src/theme/__tests__/refactor.test.ts +224 -0
  173. package/src/theme/index.ts +34 -0
  174. package/src/theme/matcher.ts +395 -0
  175. package/src/theme/parser.ts +392 -0
  176. package/src/theme/refactor.ts +360 -0
  177. package/src/theme/types.ts +152 -0
  178. package/src/tools/__tests__/gradient-generator.test.ts +206 -0
  179. package/src/tools/__tests__/palette-with-locks.test.ts +109 -0
  180. package/src/tools/color-conversion.tool.ts +54 -0
  181. package/src/tools/color-distance.tool.ts +41 -0
  182. package/src/tools/colors.ts +31 -0
  183. package/src/tools/contrast-checker.tool.ts +37 -0
  184. package/src/tools/dislike-analyzer.tool.ts +247 -0
  185. package/src/tools/gradient-generator.tool.ts +250 -0
  186. package/src/tools/image-extraction.tools.ts +289 -0
  187. package/src/tools/index.ts +39 -0
  188. package/src/tools/material-theme.tools.ts +250 -0
  189. package/src/tools/palette-generator.tool.ts +135 -0
  190. package/src/tools/palette-with-locks.tool.ts +221 -0
  191. package/src/tools/registry.ts +142 -0
  192. package/src/tools/simple-tools.ts +37 -0
  193. package/src/tools/theme-matching.tools.ts +334 -0
  194. package/src/types.ts +182 -0
  195. package/src/utils.ts +22 -0
  196. package/tsconfig.json +8 -0
  197. package/vitest.config.js +15 -0
@@ -0,0 +1,339 @@
1
+ /**
2
+ * Coolors MCP Tool - Custom Theme Styles
3
+ * Enhances VitePress default theme with Coolors branding
4
+ */
5
+
6
+ :root {
7
+ /* Brand Colors */
8
+ --app-primary: #0ea5e9;
9
+ --app-primary-dark: #0284c7;
10
+ --app-secondary: #8b5cf6;
11
+ --app-accent: #f97316;
12
+ --app-success: #10b981;
13
+ --app-warning: #f59e0b;
14
+ --app-error: #ef4444;
15
+
16
+ /* Override VitePress brand colors */
17
+ --vp-c-brand-1: var(--app-primary);
18
+ --vp-c-brand-2: var(--app-primary-dark);
19
+ --vp-c-brand-3: var(--app-secondary);
20
+ --vp-c-brand-soft: rgba(14, 165, 233, 0.14);
21
+
22
+ /* Home hero gradient */
23
+ --vp-home-hero-name-color: transparent;
24
+ --vp-home-hero-name-background: linear-gradient(
25
+ 120deg,
26
+ var(--app-primary) 30%,
27
+ var(--app-secondary)
28
+ );
29
+
30
+ /* Button styles */
31
+ --vp-button-brand-border: transparent;
32
+ --vp-button-brand-bg: var(--app-primary);
33
+ --vp-button-brand-hover-border: transparent;
34
+ --vp-button-brand-hover-bg: var(--app-primary-dark);
35
+ --vp-button-brand-active-border: transparent;
36
+ --vp-button-brand-active-bg: var(--app-primary-dark);
37
+ }
38
+
39
+ .dark {
40
+ --vp-c-brand-1: #3dd5f3;
41
+ --vp-c-brand-2: #0ea5e9;
42
+ --vp-c-brand-3: #a78bfa;
43
+ --vp-c-brand-soft: rgba(61, 213, 243, 0.16);
44
+ }
45
+
46
+ /* Hero section enhancements */
47
+ .VPHero .name {
48
+ font-weight: 700;
49
+ letter-spacing: -0.02em;
50
+ }
51
+
52
+ .VPHero .tagline {
53
+ font-size: 1.3rem;
54
+ opacity: 0.9;
55
+ line-height: 1.5;
56
+ }
57
+
58
+ /* Feature cards with hover effects */
59
+ .VPFeature {
60
+ transition: transform 0.2s ease, box-shadow 0.2s ease;
61
+ }
62
+
63
+ .VPFeature:hover {
64
+ transform: translateY(-4px);
65
+ box-shadow: 0 12px 24px rgba(0, 0, 0, 0.1);
66
+ }
67
+
68
+ .dark .VPFeature:hover {
69
+ box-shadow: 0 12px 24px rgba(0, 0, 0, 0.3);
70
+ }
71
+
72
+ /* Code blocks styling */
73
+ div[class*='language-'] {
74
+ position: relative;
75
+ border-radius: 8px;
76
+ overflow: hidden;
77
+ }
78
+
79
+ div[class*='language-']::before {
80
+ content: attr(data-lang);
81
+ position: absolute;
82
+ top: 8px;
83
+ right: 12px;
84
+ font-size: 0.75rem;
85
+ color: var(--vp-c-text-3);
86
+ text-transform: uppercase;
87
+ font-weight: 500;
88
+ }
89
+
90
+ /* Custom tool cards */
91
+ .tool-card {
92
+ padding: 1.5rem;
93
+ border: 1px solid var(--vp-c-divider);
94
+ border-radius: 12px;
95
+ margin: 1rem 0;
96
+ background: var(--vp-c-bg-soft);
97
+ transition: all 0.3s ease;
98
+ }
99
+
100
+ .tool-card:hover {
101
+ border-color: var(--app-primary);
102
+ box-shadow: 0 4px 12px rgba(14, 165, 233, 0.1);
103
+ }
104
+
105
+ .tool-card h4 {
106
+ color: var(--app-primary);
107
+ margin-top: 0;
108
+ display: flex;
109
+ align-items: center;
110
+ gap: 0.5rem;
111
+ }
112
+
113
+ .tool-card code {
114
+ background: var(--vp-c-brand-soft);
115
+ color: var(--app-primary);
116
+ padding: 2px 6px;
117
+ border-radius: 4px;
118
+ font-size: 0.9em;
119
+ }
120
+
121
+ /* Installation steps */
122
+ .installation-step {
123
+ display: flex;
124
+ align-items: flex-start;
125
+ gap: 1rem;
126
+ margin: 1.5rem 0;
127
+ }
128
+
129
+ .installation-step-number {
130
+ display: flex;
131
+ align-items: center;
132
+ justify-content: center;
133
+ width: 32px;
134
+ height: 32px;
135
+ border-radius: 50%;
136
+ background: var(--app-primary);
137
+ color: white;
138
+ font-weight: 600;
139
+ flex-shrink: 0;
140
+ }
141
+
142
+ /* Client grid cards (from getting-started) */
143
+ .client-card {
144
+ padding: 1.5rem;
145
+ border: 2px solid var(--vp-c-divider);
146
+ border-radius: 12px;
147
+ text-align: center;
148
+ transition: all 0.3s ease;
149
+ background: var(--vp-c-bg);
150
+ }
151
+
152
+ .client-card:hover {
153
+ transform: translateY(-4px);
154
+ border-color: var(--app-primary);
155
+ box-shadow: 0 8px 16px rgba(0, 0, 0, 0.1);
156
+ }
157
+
158
+ .client-card--recommended {
159
+ border-color: var(--app-primary);
160
+ position: relative;
161
+ background: linear-gradient(135deg, var(--vp-c-bg) 0%, var(--vp-c-brand-soft) 100%);
162
+ }
163
+
164
+ .client-card--recommended::before {
165
+ content: 'RECOMMENDED';
166
+ position: absolute;
167
+ top: -12px;
168
+ left: 50%;
169
+ transform: translateX(-50%);
170
+ background: var(--app-primary);
171
+ color: white;
172
+ padding: 4px 12px;
173
+ border-radius: 12px;
174
+ font-size: 0.7rem;
175
+ font-weight: 600;
176
+ letter-spacing: 0.05em;
177
+ }
178
+
179
+ .client-badge {
180
+ display: inline-block;
181
+ padding: 4px 8px;
182
+ background: var(--vp-c-brand-soft);
183
+ color: var(--app-primary);
184
+ border-radius: 4px;
185
+ font-size: 0.85rem;
186
+ margin: 0.5rem 0;
187
+ }
188
+
189
+ .client-button {
190
+ display: inline-block;
191
+ padding: 8px 16px;
192
+ background: var(--app-primary);
193
+ color: white;
194
+ border-radius: 6px;
195
+ text-decoration: none;
196
+ transition: background 0.2s ease;
197
+ margin-top: 1rem;
198
+ }
199
+
200
+ .client-button:hover {
201
+ background: var(--app-primary-dark);
202
+ }
203
+
204
+ /* Ensure VitePress link styles don't override button text color */
205
+ .vp-doc a.client-button {
206
+ color: #ffffff !important;
207
+ text-decoration: none;
208
+ }
209
+ .dark .vp-doc a.client-button {
210
+ color: #ffffff !important;
211
+ }
212
+
213
+ /* Warning/Info boxes enhancement */
214
+ .custom-block.warning {
215
+ border-color: var(--app-warning);
216
+ background-color: rgba(245, 158, 11, 0.05);
217
+ }
218
+
219
+ .custom-block.tip {
220
+ border-color: var(--app-success);
221
+ background-color: rgba(16, 185, 129, 0.05);
222
+ }
223
+
224
+ .custom-block.danger {
225
+ border-color: var(--app-error);
226
+ background-color: rgba(239, 68, 68, 0.05);
227
+ }
228
+
229
+ /* Sidebar enhancements */
230
+ .VPSidebar {
231
+ padding-top: 1rem;
232
+ }
233
+
234
+ .VPSidebarItem.is-active > .item > .link > .text {
235
+ color: var(--app-primary);
236
+ font-weight: 600;
237
+ }
238
+
239
+ /* Search box styling */
240
+ .VPNavBarSearch {
241
+ border: 1px solid var(--vp-c-divider);
242
+ border-radius: 8px;
243
+ transition: border-color 0.2s ease;
244
+ margin-left: 16px;
245
+ }
246
+
247
+ .VPNavBarSearch:hover {
248
+ border-color: var(--app-primary);
249
+ }
250
+
251
+ /* Footer enhancement */
252
+ .VPFooter {
253
+ border-top: 1px solid var(--vp-c-divider);
254
+ padding: 2rem 0;
255
+ margin-top: 4rem;
256
+ }
257
+
258
+ /* Responsive adjustments */
259
+ @media (max-width: 768px) {
260
+ .client-card {
261
+ margin: 1rem 0;
262
+ }
263
+
264
+ .tool-card {
265
+ padding: 1rem;
266
+ }
267
+ }
268
+
269
+ /* Animation for loading states */
270
+ @keyframes pulse {
271
+ 0%, 100% {
272
+ opacity: 1;
273
+ }
274
+ 50% {
275
+ opacity: 0.5;
276
+ }
277
+ }
278
+
279
+ .loading {
280
+ animation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
281
+ }
282
+
283
+ /* Custom scrollbar */
284
+ ::-webkit-scrollbar {
285
+ width: 8px;
286
+ height: 8px;
287
+ }
288
+
289
+ ::-webkit-scrollbar-track {
290
+ background: var(--vp-c-bg-soft);
291
+ }
292
+
293
+ ::-webkit-scrollbar-thumb {
294
+ background: var(--vp-c-divider);
295
+ border-radius: 4px;
296
+ }
297
+
298
+ ::-webkit-scrollbar-thumb:hover {
299
+ background: var(--app-primary);
300
+ }
301
+
302
+ /* Code snippet copy button enhancement */
303
+ div[class*='language-'] .copy {
304
+ background-color: var(--vp-c-bg-soft);
305
+ border: 1px solid var(--vp-c-divider);
306
+ border-radius: 4px;
307
+ transition: all 0.2s ease;
308
+ }
309
+
310
+ div[class*='language-'] .copy:hover {
311
+ background-color: var(--app-primary);
312
+ border-color: var(--app-primary);
313
+ }
314
+
315
+ /* Badge styles for tool categories */
316
+ .tool-badge {
317
+ display: inline-block;
318
+ padding: 2px 8px;
319
+ border-radius: 12px;
320
+ font-size: 0.75rem;
321
+ font-weight: 500;
322
+ text-transform: uppercase;
323
+ letter-spacing: 0.05em;
324
+ }
325
+
326
+ .tool-badge.core {
327
+ background: var(--app-success);
328
+ color: white;
329
+ }
330
+
331
+ .tool-badge.advanced {
332
+ background: var(--app-secondary);
333
+ color: white;
334
+ }
335
+
336
+ .tool-badge.utility {
337
+ background: var(--app-accent);
338
+ color: white;
339
+ }