xw-devtool-cli 1.0.21 → 1.0.23

package/README.md

@@ -12,6 +12,8 @@
 - **图片工具**：
   - **图片格式转换**：支持 PNG、JPG、WebP、ICO 格式互转，可调整压缩质量。生成 ICO 时支持自定义尺寸（逗号分隔），留空则默认生成 `256` 尺寸。输出文件名默认带时间戳，避免覆盖。
   - **图片 ↔ Base64**：支持图片转 Base64 字符串，以及 Base64 还原为图片文件。
+  - **图片分割**：支持网格等分（自定义行/列数）或自定义分割线（像素/百分比），自动生成分割后的图片文件。
+  - **图片主色识别**：提取图片主色调（Hex/RGB/HSL/HSV），默认复制 Hex 到剪贴板，支持保存详细信息到文件。
   - **占位图生成**：快速生成指定尺寸、颜色、文字的占位图片 (Placeholder Image)。
 - **Mock 数据生成**：
   - 支持生成：英文段落 (Lorem Ipsum)、中文字符、中国居民身份证号、电子邮箱、URL、订单号、手机号、座机号。
@@ -79,7 +81,8 @@ xw-devtool --en  # 英文启动 (Start in English)
 1. 图片 ↔ Base64
 2. 图片格式转换
 3. 占位图生成
-4. 二维码生成
+4. 图片主色识别
+5. 二维码生成
 5. URL 编解码
 6. 字符串 Base64 转换
 7. Unicode 编解码
@@ -290,6 +293,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/README_EN.md

@@ -12,6 +12,7 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
 - **Image Tools**:
   - **Format Conversion**: Convert between PNG, JPG, WebP, with adjustable compression quality.
   - **Image ↔ Base64**: Convert images to Base64 strings and vice versa.
+  - **Image Splitter**: Split images into grid (rows/cols) or custom split lines (pixels/percentage).
   - **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.23",
   "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/commands/imgSplit.js

@@ -0,0 +1,173 @@
+import inquirer from 'inquirer';
+import fs from 'fs';
+import path from 'path';
+import sharp from 'sharp';
+import i18next from '../i18n.js';
+import { selectFromMenu } from '../utils/menu.js';
+import { selectFile } from '../utils/fileDialog.js';
+
+async function pickInputFile() {
+    const method = await selectFromMenu('Image Splitter - 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|All Files|*.*') || '';
+        if (!filePath) {
+            console.log('File dialog not available or canceled. Please enter path manually.');
+        }
+    }
+    if (!filePath) {
+        const ans = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'filePath',
+                message: 'Enter image file path:',
+                validate: (input) => (fs.existsSync(input) ? true : 'File does not exist.')
+            }
+        ]);
+        filePath = ans.filePath;
+    }
+    return filePath;
+}
+
+function parseSplitLines(input, totalSize) {
+    if (!input || !input.trim()) return [0, totalSize];
+
+    const tokens = input.trim().split(/[\s,]+/);
+    const points = tokens.map(t => {
+        t = t.trim();
+        let val = 0;
+        if (t.endsWith('px')) {
+            val = parseFloat(t.replace('px', ''));
+        } else if (t.endsWith('%')) {
+            val = (parseFloat(t.replace('%', '')) / 100) * totalSize;
+        } else {
+            // Default to percentage as per requirement
+            val = (parseFloat(t) / 100) * totalSize;
+        }
+        return Math.round(val);
+    });
+
+    // Filter valid points
+    const validPoints = points.filter(p => p > 0 && p < totalSize);
+    
+    // Add start and end
+    const allPoints = [0, ...validPoints, totalSize];
+    
+    // Sort and unique
+    return [...new Set(allPoints)].sort((a, b) => a - b);
+}
+
+export async function imgSplitHandler() {
+    console.log('\nStarting Image Splitter...');
+    const inputPath = await pickInputFile();
+    
+    if (!inputPath) {
+        console.log('No file selected.');
+        return;
+    }
+
+    const image = sharp(inputPath);
+    const metadata = await image.metadata();
+    const { width, height, format } = metadata;
+
+    console.log(`Image: ${inputPath} (${width}x${height})`);
+
+    const mode = await selectFromMenu(i18next.t('imgSplit.mode'), [
+        { name: i18next.t('imgSplit.modeGrid'), value: 'grid' },
+        { name: i18next.t('imgSplit.modeCustom'), value: 'custom' }
+    ]);
+
+    let xPoints = [];
+    let yPoints = [];
+
+    if (mode === 'grid') {
+        const { rows, cols } = await inquirer.prompt([
+            {
+                type: 'number',
+                name: 'rows',
+                message: i18next.t('imgSplit.rows'),
+                default: 2,
+                validate: n => n > 0 || 'Must be > 0'
+            },
+            {
+                type: 'number',
+                name: 'cols',
+                message: i18next.t('imgSplit.cols'),
+                default: 2,
+                validate: n => n > 0 || 'Must be > 0'
+            }
+        ]);
+
+        // Generate points for grid
+        for (let i = 0; i <= cols; i++) {
+            xPoints.push(Math.round((i * width) / cols));
+        }
+        for (let i = 0; i <= rows; i++) {
+            yPoints.push(Math.round((i * height) / rows));
+        }
+    } else {
+        const { hLines, vLines } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'hLines',
+                message: i18next.t('imgSplit.hLines'),
+            },
+            {
+                type: 'input',
+                name: 'vLines',
+                message: i18next.t('imgSplit.vLines'),
+            }
+        ]);
+
+        // hLines are horizontal lines, so they split the Y axis (height)
+        // vLines are vertical lines, so they split the X axis (width)
+        yPoints = parseSplitLines(hLines, height);
+        xPoints = parseSplitLines(vLines, width);
+    }
+
+    // Create output directory
+    const dir = path.dirname(inputPath);
+    const base = path.basename(inputPath, path.extname(inputPath));
+    const ts = Date.now();
+    const outDir = path.join(dir, `${base}_split_${ts}`);
+    
+    if (!fs.existsSync(outDir)) {
+        fs.mkdirSync(outDir);
+    }
+
+    let count = 0;
+    // Iterate regions
+    // xPoints: [0, x1, x2, ..., width]
+    // yPoints: [0, y1, y2, ..., height]
+    
+    const tasks = [];
+
+    for (let y = 0; y < yPoints.length - 1; y++) {
+        for (let x = 0; x < xPoints.length - 1; x++) {
+            const left = xPoints[x];
+            const top = yPoints[y];
+            const regionWidth = xPoints[x+1] - xPoints[x];
+            const regionHeight = yPoints[y+1] - yPoints[y];
+
+            if (regionWidth <= 0 || regionHeight <= 0) continue;
+
+            const outName = `${base}_${y}_${x}.${format}`;
+            const outPath = path.join(outDir, outName);
+
+            tasks.push(
+                image
+                    .clone()
+                    .extract({ left, top, width: regionWidth, height: regionHeight })
+                    .toFile(outPath)
+            );
+            count++;
+        }
+    }
+
+    await Promise.all(tasks);
+
+    console.log(i18next.t('imgSplit.success', { count, path: outDir }));
+}

package/src/index.js

@@ -8,6 +8,7 @@ import { base64Handler } from './commands/base64.js';
 import { unicodeHandler } from './commands/unicode.js';
 import { imgBase64Handler } from './commands/imgBase64.js';
 import { imgConvertHandler } from './commands/imgConvert.js';
+import { imgSplitHandler } from './commands/imgSplit.js';
 import { timeFormatHandler } from './commands/timeFormat.js';
 import { timeCalcHandler } from './commands/timeCalc.js';
 import { mockHandler } from './commands/mock.js';
@@ -24,6 +25,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 +47,8 @@ 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.imgSplit'), value: 'imgSplit' },
+        { name: i18next.t('menu.features.dominantColor'), value: 'dominantColor' },
         { name: i18next.t('menu.features.placeholderImg'), value: 'placeholderImg' },
         { name: i18next.t('menu.features.qrcode'), value: 'qrcode' },
         
@@ -146,6 +150,7 @@ async function showMenu() {
     const selectedFeature = features[index];
     
     try {
+        // console.log('Handling action:', selectedFeature.value);
         await handleAction(selectedFeature.value);
     } catch (error) {
         console.error('Error:', error.message);
@@ -171,6 +176,12 @@ async function handleAction(action) {
         case 'imgConvert':
             await imgConvertHandler();
             break;
+        case 'imgSplit':
+            await imgSplitHandler();
+            break;
+        case 'dominantColor':
+            await dominantColorHandler();
+            break;
         case 'timeFormat':
             await timeFormatHandler();
             break;

package/src/locales/en.js

@@ -8,6 +8,8 @@ export default {
         features: {
             imgBase64: 'Image <-> Base64',
             imgConvert: 'Image Format Convert',
+            imgSplit: 'Image Splitter',
+            dominantColor: 'Image Dominant Color',
             placeholderImg: 'Placeholder Image Generator',
             qrcode: 'QR Code Generator',
             url: 'URL Encode/Decode',
@@ -42,5 +44,15 @@ export default {
         inputPrompt: 'Enter URL to {{mode}}:',
         result: 'Result:',
         error: 'Error processing URL:'
+    },
+    imgSplit: {
+        mode: 'Select split mode',
+        modeGrid: 'Grid Split (Equal parts)',
+        modeCustom: 'Custom Split Lines',
+        rows: 'Number of rows:',
+        cols: 'Number of columns:',
+        hLines: 'Horizontal split lines (e.g. 10 20 30 or 10% 20%):',
+        vLines: 'Vertical split lines (e.g. 10 20 30 or 10% 20%):',
+        success: 'Successfully split image into {{count}} parts. Saved to {{path}}'
     }
 };

package/src/locales/zh.js

@@ -8,6 +8,8 @@ export default {
         features: {
             imgBase64: '图片 <-> Base64',
             imgConvert: '图片格式转换',
+            imgSplit: '图片分割工具',
+            dominantColor: '图片主色识别',
             placeholderImg: '占位图生成器',
             qrcode: '二维码生成器',
             url: 'URL 编码/解码',
@@ -42,5 +44,15 @@ export default {
         inputPrompt: '请输入要{{mode}}的 URL:',
         result: '结果:',
         error: '处理 URL 时出错:'
+    },
+    imgSplit: {
+        mode: '选择分割模式',
+        modeGrid: '网格分割 (等分)',
+        modeCustom: '自定义分割线',
+        rows: '行数:',
+        cols: '列数:',
+        hLines: '水平分割线 (例如 10 20 30 或 10% 20%):',
+        vLines: '垂直分割线 (例如 10 20 30 或 10% 20%):',
+        success: '成功将图片分割为 {{count}} 份。保存至 {{path}}'
     }
 };