xw-devtool-cli 1.0.21 → 1.0.22

package/README.md

@@ -12,6 +12,7 @@
 - **图片工具**：
   - **图片格式转换**：支持 PNG、JPG、WebP、ICO 格式互转，可调整压缩质量。生成 ICO 时支持自定义尺寸（逗号分隔），留空则默认生成 `256` 尺寸。输出文件名默认带时间戳，避免覆盖。
   - **图片 ↔ Base64**：支持图片转 Base64 字符串，以及 Base64 还原为图片文件。
+  - **图片主色识别**：提取图片主色调（Hex/RGB/HSL/HSV），默认复制 Hex 到剪贴板，支持保存详细信息到文件。
   - **占位图生成**：快速生成指定尺寸、颜色、文字的占位图片 (Placeholder Image)。
 - **Mock 数据生成**：
   - 支持生成：英文段落 (Lorem Ipsum)、中文字符、中国居民身份证号、电子邮箱、URL、订单号、手机号、座机号。
@@ -79,7 +80,8 @@ xw-devtool --en  # 英文启动 (Start in English)
 1. 图片 ↔ Base64
 2. 图片格式转换
 3. 占位图生成
-4. 二维码生成
+4. 图片主色识别
+5. 二维码生成
 5. URL 编解码
 6. 字符串 Base64 转换
 7. Unicode 编解码
@@ -290,6 +292,7 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
 - **Image Tools**:
   - **Format Conversion**: Convert between PNG, JPG, WebP, ICO, with adjustable compression quality. For ICO, you can specify sizes (comma-separated); leave empty to generate `256` size by default. Output filenames include timestamps to avoid overwriting.
   - **Image ↔ Base64**: Convert images to Base64 strings and vice versa.
+  - **Image Dominant Color**: Extract dominant color (Hex/RGB/HSL/HSV), copy Hex to clipboard by default, or save details to file.
   - **Placeholder Image**: Quickly generate placeholder images with custom size, color, and text.
 - **Mock Data**:
   - Generate: Lorem Ipsum, Chinese characters, ID cards, Emails, URLs, Order IDs, Phone numbers.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",

package/src/commands/dominantColor.js

@@ -0,0 +1,109 @@
+import inquirer from 'inquirer';
+import sharp from 'sharp';
+import tinycolor from 'tinycolor2';
+import { selectFromMenu } from '../utils/menu.js';
+import { selectFile, saveFile } from '../utils/fileDialog.js';
+import { outputText, defaultFileName } from '../utils/output.js';
+
+export async function dominantColorHandler() {
+    const method = await selectFromMenu('Image input method', [
+        { name: 'Select file (dialog)', value: 'dialog' },
+        { name: 'Enter file path manually', value: 'manual' }
+    ]);
+
+    let filePath = '';
+    if (method === 'dialog') {
+        filePath = selectFile('Image Files|*.png;*.jpg;*.jpeg;*.webp;*.gif|All Files|*.*') || '';
+    }
+    if (!filePath) {
+        const ans = await inquirer.prompt([
+            { type: 'input', name: 'filePath', message: 'Enter image file path:' }
+        ]);
+        filePath = ans.filePath;
+    }
+
+    try {
+        const image = sharp(filePath);
+        // Resize to 100x100 to speed up processing while maintaining color distribution
+        const { data, info } = await image
+            .resize(100, 100, { fit: 'inside' })
+            .ensureAlpha()
+            .raw()
+            .toBuffer({ resolveWithObject: true });
+
+        const pixelCount = info.width * info.height;
+        const colorMap = new Map();
+
+        // Quantize colors to group similar ones (4 bits per channel = 16 values per channel)
+        for (let i = 0; i < pixelCount; i++) {
+            const offset = i * 4;
+            const r = data[offset];
+            const g = data[offset + 1];
+            const b = data[offset + 2];
+            const a = data[offset + 3];
+
+            if (a < 128) continue; // Ignore transparent pixels
+
+            // Quantize: divide by 16 (right shift 4)
+            const key = `${r >> 4}-${g >> 4}-${b >> 4}`;
+            
+            if (!colorMap.has(key)) {
+                colorMap.set(key, { count: 0, r: 0, g: 0, b: 0 });
+            }
+            
+            const bucket = colorMap.get(key);
+            bucket.count++;
+            bucket.r += r;
+            bucket.g += g;
+            bucket.b += b;
+        }
+
+        let maxCount = 0;
+        let dominant = { r: 0, g: 0, b: 0 };
+
+        for (const bucket of colorMap.values()) {
+            if (bucket.count > maxCount) {
+                maxCount = bucket.count;
+                dominant = {
+                    r: Math.round(bucket.r / bucket.count),
+                    g: Math.round(bucket.g / bucket.count),
+                    b: Math.round(bucket.b / bucket.count)
+                };
+            }
+        }
+
+        const { r, g, b } = dominant;
+        const hex = tinycolor({ r, g, b }).toHexString().toUpperCase();
+        const rgb = `rgb(${r}, ${g}, ${b})`;
+        const hsl = tinycolor({ r, g, b }).toHslString();
+        const hsv = tinycolor({ r, g, b }).toHsvString();
+
+        const text = [
+            '=== Dominant Color ===',
+            `Hex: ${hex}`,
+            `RGB: ${rgb}`,
+            `HSL: ${hsl}`,
+            `HSV: ${hsv}`,
+            '======================'
+        ].join('\n');
+
+        const outputMethod = await selectFromMenu('Output', [
+            { name: 'Copy Hex to clipboard', value: 'copy' },
+            { name: 'Save details to file', value: 'file' },
+            { name: 'Preview + copy Hex', value: 'preview' }
+        ]);
+
+        if (outputMethod === 'file') {
+            const def = defaultFileName('dominant-color', 'txt');
+            const out = saveFile(def, 'Text Files|*.txt|All Files|*.*') || def;
+            await outputText(text, { showPreview: false, savePath: out });
+        } else if (outputMethod === 'preview') {
+            await outputText(text, { showPreview: true });
+            await outputText(hex, { showPreview: false });
+        } else {
+            await outputText(hex, { showPreview: false });
+        }
+    } catch (e) {
+        console.error('Failed to analyze image:', e.message);
+    }
+}

package/src/index.js

@@ -24,6 +24,7 @@ import { htmlEntitiesHandler } from './commands/htmlEntities.js';
 import { placeholderImgHandler } from './commands/placeholderImg.js';
 import { markdownHandler } from './commands/markdown.js';
 import { vscodeSnippetHandler } from './commands/vscodeSnippet.js';
+import { dominantColorHandler } from './commands/dominantColor.js';
 
 process.on('SIGINT', () => {
     console.log(`\n${i18next.t('menu.bye')}`);
@@ -45,6 +46,7 @@ function getFeatures() {
         // Image Tools
         { name: i18next.t('menu.features.imgBase64'), value: 'imgBase64' },
         { name: i18next.t('menu.features.imgConvert'), value: 'imgConvert' },
+        { name: i18next.t('menu.features.dominantColor'), value: 'dominantColor' },
         { name: i18next.t('menu.features.placeholderImg'), value: 'placeholderImg' },
         { name: i18next.t('menu.features.qrcode'), value: 'qrcode' },
         
@@ -171,6 +173,9 @@ async function handleAction(action) {
         case 'imgConvert':
             await imgConvertHandler();
             break;
+        case 'dominantColor':
+            await dominantColorHandler();
+            break;
         case 'timeFormat':
             await timeFormatHandler();
             break;

package/src/locales/en.js

@@ -8,6 +8,7 @@ export default {
         features: {
             imgBase64: 'Image <-> Base64',
             imgConvert: 'Image Format Convert',
+            dominantColor: 'Image Dominant Color',
             placeholderImg: 'Placeholder Image Generator',
             qrcode: 'QR Code Generator',
             url: 'URL Encode/Decode',

package/src/locales/zh.js

@@ -8,6 +8,7 @@ export default {
         features: {
             imgBase64: '图片 <-> Base64',
             imgConvert: '图片格式转换',
+            dominantColor: '图片主色识别',
             placeholderImg: '占位图生成器',
             qrcode: '二维码生成器',
             url: 'URL 编码/解码',