@trishchuk/coolors-mcp 1.0.0 → 1.0.1

package/TOOLS_UK.md

@@ -0,0 +1,233 @@
+# Інструменти Coolors MCP
+
+## 🎨 Конвертація кольорів
+
+### convert_color
+
+Конвертує кольори між форматами: hex, rgb, hsl, lab, hct
+
+```javascript
+{ color: "#6366f1", to: "hct" }
+// Результат: "hct(265.8, 87.2, 47.9)"
+```
+
+## 📏 Вимірювання відстані
+
+### color_distance
+
+Обчислює перцептивну відстань між кольорами
+
+```javascript
+{ color1: "#6366f1", color2: "#5355d1", metric: "deltaE2000" }
+// Результат: 5.2 (помітна різниця)
+```
+
+## ♿ Перевірка контрасту
+
+### check_contrast
+
+Перевіряє контраст за стандартами WCAG
+
+```javascript
+{ foreground: "#000000", background: "#ffffff" }
+// Результат: 21:1 ✓ AAA
+```
+
+## 🎨 Генерація палітр
+
+### generate_palette
+
+Створює палітри: монохроматичні, аналогові, комплементарні, тріадні, тетрадні
+
+```javascript
+{ baseColor: "#6366f1", type: "analogous", count: 5 }
+```
+
+### generate_palette_with_locks
+
+Генерує палітру зі збереженням заданих кольорів
+
+```javascript
+{ lockedColors: ["#6366f1", "#ec4899"], totalColors: 7, mode: "harmony" }
+```
+
+### generate_gradient
+
+Створює плавні градієнти
+
+```javascript
+{
+  colors: ["#6366f1", "#ec4899"],
+  steps: 10,
+  interpolation: "lab"  // lab, hsl, rgb, hct
+}
+```
+
+## 🎭 Material Design 3
+
+### generate_material_theme
+
+Генерує повну тему Material Design 3
+
+```javascript
+{ sourceColor: "#6366f1", includeCustomColors: true }
+// Результат: light/dark схеми + тональні палітри
+```
+
+### generate_tonal_palette
+
+Створює тональну палітру (0-100)
+
+```javascript
+{ color: "#6366f1", tones: [0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 95, 99, 100] }
+```
+
+### harmonize_colors
+
+Гармонізує кольори для спільної роботи
+
+```javascript
+{ colors: ["#6366f1", "#ec4899", "#10b981"], method: "harmonize", factor: 0.5 }
+```
+
+## 🔍 Підбір змінних теми
+
+### match_theme_color
+
+Знаходить найближчу CSS змінну для кольору
+
+```javascript
+{
+  color: "#6366f1",
+  themeCSS: ":root { --primary: #6366f1; }",
+  context: "background",
+  minConfidence: 70
+}
+```
+
+### refactor_css_with_theme
+
+Автоматично замінює кольори на змінні теми
+
+```javascript
+{
+  css: ".btn { background: #6366f1; }",
+  themeCSS: ":root { --primary: #6366f1; }",
+  preserveOriginal: true
+}
+// Результат: .btn { background: var(--primary); /* was: #6366f1 */ }
+```
+
+### match_theme_colors_batch
+
+Підбирає змінні для багатьох кольорів
+
+```javascript
+{
+  colors: ["#6366f1", "#ec4899", "#10b981"],
+  themeCSS: "/* CSS зі змінними */"
+}
+```
+
+### generate_theme_css
+
+Генерує CSS змінні для теми
+
+```javascript
+{
+  sourceColor: "#6366f1",
+  prefix: "color",
+  includeTones: [0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 95, 99, 100]
+}
+```
+
+## 🖼️ Витягування кольорів з зображень
+
+### extract_image_colors
+
+Витягує домінантні кольори алгоритмом Celebi
+
+```javascript
+{ imageData: [/* RGBA масив */], maxColors: 5, minPopulation: 0.01 }
+// Результат: масив кольорів з популяцією та оцінкою для UI
+```
+
+### generate_theme_from_image
+
+Генерує Material тему з кольорів зображення
+
+```javascript
+{
+  imageData: [/* пікселі */],
+  variant: "vibrant",  // tonalSpot, fidelity, expressive, neutral, monochrome
+  contrastLevel: 0.5   // 0 (стандарт), 0.5 (середній), 1.0 (високий)
+}
+```
+
+## 🚫 Аналіз неприємних кольорів
+
+### analyze_color_likability
+
+Перевіряє чи колір у "зоні огиди" (темні жовто-зелені)
+
+```javascript
+{ color: "#6b7c3a", autoFix: true }
+// Результат: виправлений колір + пояснення
+```
+
+### fix_disliked_colors_batch
+
+Виправляє кілька неприємних кольорів
+
+```javascript
+{
+  colors: ["#6b7c3a", "#5c6b2f"],
+  strategy: "both"  // shift, lighten, both
+}
+```
+
+## Ключові особливості
+
+### HCT колірний простір
+
+- **Тон** (0-360°): позиція на колірному колі
+- **Хрома** (0-150): насиченість
+- **Тональність** (0-100): світлість з гарантованим контрастом
+  - Різниця 40 = контраст 3:1
+  - Різниця 50 = контраст 4.5:1
+
+### Алгоритм підбору теми
+
+1. Перцептивна відстань (60%) - схожість за HCT
+2. Семантичний контекст (20%) - відповідність ролі
+3. Доступність (20%) - дотримання контрасту
+
+### Варіанти Material теми
+
+- **tonalSpot** - збалансована (за замовчуванням)
+- **fidelity** - зберігає бренд-колір точно
+- **vibrant** - яскрава, грайлива
+- **expressive** - креативні комбінації
+- **neutral** - професійна, мінімальна
+- **monochrome** - один відтінок
+
+## Швидкий старт
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "coolors": {
+      "command": "npx",
+      "args": ["-y", "@trishchuk/coolors-mcp"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add coolors --npm-package @trishchuk/coolors-mcp
+```

package/docs/.vitepress/cache/deps/@braintree_sanitize-url.js

@@ -1,22 +1,29 @@
-import {
-  __commonJS
-} from "./chunk-BUSYA2B4.js";
+import { __commonJS } from "./chunk-BUSYA2B4.js";
 
 // node_modules/@braintree/sanitize-url/dist/constants.js
 var require_constants = __commonJS({
   "node_modules/@braintree/sanitize-url/dist/constants.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.BLANK_URL = exports.relativeFirstCharacters = exports.whitespaceEscapeCharsRegex = exports.urlSchemeRegex = exports.ctrlCharactersRegex = exports.htmlCtrlEntityRegex = exports.htmlEntitiesRegex = exports.invalidProtocolRegex = void 0;
+    exports.BLANK_URL =
+      exports.relativeFirstCharacters =
+      exports.whitespaceEscapeCharsRegex =
+      exports.urlSchemeRegex =
+      exports.ctrlCharactersRegex =
+      exports.htmlCtrlEntityRegex =
+      exports.htmlEntitiesRegex =
+      exports.invalidProtocolRegex =
+        void 0;
     exports.invalidProtocolRegex = /^([^\w]*)(javascript|data|vbscript)/im;
     exports.htmlEntitiesRegex = /&#(\w+)(^\w|;)?/g;
     exports.htmlCtrlEntityRegex = /&(newline|tab);/gi;
-    exports.ctrlCharactersRegex = /[\u0000-\u001F\u007F-\u009F\u2000-\u200D\uFEFF]/gim;
+    exports.ctrlCharactersRegex =
+      /[\u0000-\u001F\u007F-\u009F\u2000-\u200D\uFEFF]/gim;
     exports.urlSchemeRegex = /^.+(:|:)/gim;
     exports.whitespaceEscapeCharsRegex = /(\\|%5[cC])((%(6[eE]|72|74))|[nrt])/g;
     exports.relativeFirstCharacters = [".", "/"];
     exports.BLANK_URL = "about:blank";
-  }
+  },
 });
 
 // node_modules/@braintree/sanitize-url/dist/index.js
@@ -30,9 +37,12 @@ var require_dist = __commonJS({
     }
     function decodeHtmlCharacters(str) {
       var removedNullByte = str.replace(constants_1.ctrlCharactersRegex, "");
-      return removedNullByte.replace(constants_1.htmlEntitiesRegex, function(match, dec) {
-        return String.fromCharCode(dec);
-      });
+      return removedNullByte.replace(
+        constants_1.htmlEntitiesRegex,
+        function (match, dec) {
+          return String.fromCharCode(dec);
+        },
+      );
     }
     function isValidUrl(url) {
       return URL.canParse(url);
@@ -51,9 +61,17 @@ var require_dist = __commonJS({
       var charsToDecode;
       var decodedUrl = decodeURI(url.trim());
       do {
-        decodedUrl = decodeHtmlCharacters(decodedUrl).replace(constants_1.htmlCtrlEntityRegex, "").replace(constants_1.ctrlCharactersRegex, "").replace(constants_1.whitespaceEscapeCharsRegex, "").trim();
+        decodedUrl = decodeHtmlCharacters(decodedUrl)
+          .replace(constants_1.htmlCtrlEntityRegex, "")
+          .replace(constants_1.ctrlCharactersRegex, "")
+          .replace(constants_1.whitespaceEscapeCharsRegex, "")
+          .trim();
         decodedUrl = decodeURI(decodedUrl);
-        charsToDecode = decodedUrl.match(constants_1.ctrlCharactersRegex) || decodedUrl.match(constants_1.htmlEntitiesRegex) || decodedUrl.match(constants_1.htmlCtrlEntityRegex) || decodedUrl.match(constants_1.whitespaceEscapeCharsRegex);
+        charsToDecode =
+          decodedUrl.match(constants_1.ctrlCharactersRegex) ||
+          decodedUrl.match(constants_1.htmlEntitiesRegex) ||
+          decodedUrl.match(constants_1.htmlCtrlEntityRegex) ||
+          decodedUrl.match(constants_1.whitespaceEscapeCharsRegex);
       } while (charsToDecode && charsToDecode.length > 0);
       var sanitizedUrl = decodedUrl;
       if (!sanitizedUrl) {
@@ -87,7 +105,7 @@ var require_dist = __commonJS({
       return backSanitized;
     }
     exports.sanitizeUrl = sanitizeUrl;
-  }
+  },
 });
 export default require_dist();
 //# sourceMappingURL=@braintree_sanitize-url.js.map

package/docs/.vitepress/cache/deps/_metadata.json

@@ -124,4 +124,4 @@
       "file": "chunk-BUSYA2B4.js"
     }
   }
-}
+}

package/docs/.vitepress/cache/deps/chunk-BUSYA2B4.js

@@ -1,9 +1,12 @@
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
+var __commonJS = (cb, mod) =>
+  function __require() {
+    return (
+      mod ||
+        (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod),
+      mod.exports
+    );
+  };
 
-export {
-  __commonJS
-};
+export { __commonJS };
 //# sourceMappingURL=chunk-BUSYA2B4.js.map