xw-devtool-cli 1.0.22 → 1.0.24

package/README.md

@@ -12,6 +12,7 @@
 - **图片工具**：
   - **图片格式转换**：支持 PNG、JPG、WebP、ICO 格式互转，可调整压缩质量。生成 ICO 时支持自定义尺寸（逗号分隔），留空则默认生成 `256` 尺寸。输出文件名默认带时间戳，避免覆盖。
   - **图片 ↔ Base64**：支持图片转 Base64 字符串，以及 Base64 还原为图片文件。
+  - **图片分割**：支持网格等分（自定义行/列数）或自定义分割线（像素/百分比），自动生成分割后的图片文件。
   - **图片主色识别**：提取图片主色调（Hex/RGB/HSL/HSV），默认复制 Hex 到剪贴板，支持保存详细信息到文件。
   - **占位图生成**：快速生成指定尺寸、颜色、文字的占位图片 (Placeholder Image)。
 - **Mock 数据生成**：
@@ -27,6 +28,7 @@
   - **UUID**：生成 UUID v4。
   - **中文转拼音**：将汉字转换为不带声调的拼音。
   - **颜色转换**：Hex <-> RGB 互转。
+  - **颜色预览**：输入颜色并在终端显示颜色条，便于快速视觉确认，同时自动复制 Hex 到剪贴板。
   - **变量格式转换**：支持 CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase 互转。
   - **哈希计算**：支持 MD5, SHA1, SHA256, SHA512, SM3 算法。
   - **二维码生成**：终端直接显示二维码，支持保存为 PNG 图片（带时间戳文件名）。

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.
@@ -26,6 +27,7 @@ Key features include: Base64 encoding/decoding, image format conversion, image <
   - **UUID**: Generate UUID v4.
   - **Pinyin**: Convert Chinese characters to Pinyin (without tone).
   - **Color Converter**: Hex <-> RGB.
+  - **Color Preview**: Enter a color and display a color bar in terminal for quick visual confirmation; Hex is auto-copied to clipboard.
   - **Variable Format**: CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase.
   - **Hash Calculator**: MD5, SHA1, SHA256, SHA512, SM3.
   - **QR Code**: Display QR codes in terminal, save as PNG.

package/package.json

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

package/src/commands/colorPreview.js

@@ -0,0 +1,72 @@
+import inquirer from 'inquirer';
+import tinycolor from 'tinycolor2';
+import { copy } from '../utils/clipboard.js';
+import i18next from '../i18n.js';
+// No width/height selection per user request; fixed size preview
+
+function blend(fg, bg, alpha) {
+    const a = Math.max(0, Math.min(1, alpha ?? 1));
+    return {
+        r: Math.round(a * fg.r + (1 - a) * bg.r),
+        g: Math.round(a * fg.g + (1 - a) * bg.g),
+        b: Math.round(a * fg.b + (1 - a) * bg.b),
+    };
+}
+
+function printColorBar(rgb, width = 50, height = 2, label = '', alpha = 1) {
+    const reset = '\x1b[0m';
+    const block = ' ';
+    if (label) {
+        console.log(label);
+    }
+    const useChecker = alpha < 1;
+    const bg1 = { r: 255, g: 255, b: 255 };
+    const bg2 = { r: 204, g: 204, b: 204 };
+    for (let row = 0; row < height; row++) {
+        let line = '';
+        for (let col = 0; col < width; col++) {
+            const checker = ((Math.floor(row / 1) + Math.floor(col / 2)) % 2 === 0) ? bg1 : bg2;
+            const blended = useChecker ? blend(rgb, checker, alpha) : rgb;
+            const bg = `\x1b[48;2;${blended.r};${blended.g};${blended.b}m`;
+            line += `${bg}${block}`;
+        }
+        line += reset;
+        console.log(line);
+    }
+}
+
+function isAllowedColorFormat(val) {
+    if (!val || typeof val !== 'string') return false;
+    const s = val.trim();
+    const hex = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+    const rgb = /^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/i;
+    const rgba = /^rgba\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(?:0|1|0?\.\d+)\s*\)$/i;
+    const hsl = /^hsl\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*\)$/i;
+    const hsla = /^hsla\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*,\s*(?:0|1|0?\.\d+)\s*\)$/i;
+    return hex.test(s) || rgb.test(s) || rgba.test(s) || hsl.test(s) || hsla.test(s);
+}
+
+export async function colorPreviewHandler() {
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: i18next.t('colorPreview.input'),
+            validate: (val) => isAllowedColorFormat(val) || i18next.t('colorPreview.invalid')
+        }
+    ]);
+
+    const color = tinycolor(input);
+    const rgb = color.toRgb();
+    const alpha = typeof rgb.a === 'number' ? rgb.a : 1;
+    const hex = alpha < 1 ? color.toHex8String().toUpperCase() : color.toHexString().toUpperCase();
+
+    const width = 50;
+    const height = 2;
+
+    const label = `${i18next.t('colorPreview.preview')} ${hex} ${color.toRgbString()} ${color.toHslString()}`;
+    printColorBar(rgb, width, height, label, alpha);
+
+    await copy(hex);
+    console.log(i18next.t('colorPreview.copied', { value: hex }));
+}

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,12 +8,14 @@ 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';
 import { uuidHandler } from './commands/uuid.js';
 import { pinyinHandler } from './commands/pinyin.js';
 import { colorHandler } from './commands/color.js';
+import { colorPreviewHandler } from './commands/colorPreview.js';
 import { variableFormatHandler } from './commands/variableFormat.js';
 import { jsonFormatHandler } from './commands/jsonFormat.js';
 import { hashingHandler } from './commands/hashing.js';
@@ -46,6 +48,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.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' },
@@ -63,6 +66,7 @@ function getFeatures() {
         { name: i18next.t('menu.features.timeFormat'), value: 'timeFormat' },
         { name: i18next.t('menu.features.timeCalc'), value: 'timeCalc' },
         { name: i18next.t('menu.features.color'), value: 'color' },
+        { name: i18next.t('menu.features.colorPreview'), value: 'colorPreview' },
         { name: i18next.t('menu.features.uuid'), value: 'uuid' },
         { name: i18next.t('menu.features.hashing'), value: 'hashing' },
 
@@ -148,6 +152,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);
@@ -173,6 +178,9 @@ async function handleAction(action) {
         case 'imgConvert':
             await imgConvertHandler();
             break;
+        case 'imgSplit':
+            await imgSplitHandler();
+            break;
         case 'dominantColor':
             await dominantColorHandler();
             break;
@@ -194,6 +202,9 @@ async function handleAction(action) {
         case 'color':
             await colorHandler();
             break;
+        case 'colorPreview':
+            await colorPreviewHandler();
+            break;
         case 'variableFormat':
             await variableFormatHandler();
             break;

package/src/locales/en.js

@@ -8,6 +8,7 @@ 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',
@@ -21,6 +22,7 @@ export default {
             timeFormat: 'Time Format / Timestamp',
             timeCalc: 'Time Calculation (Diff/Offset)',
             color: 'Color Converter (Hex <-> RGB)',
+            colorPreview: 'Color Preview',
             uuid: 'Get UUID',
             hashing: 'Hash Calculator (MD5/SHA/SM3)',
             mock: 'Mock Text',
@@ -36,6 +38,12 @@ export default {
         saved: 'Language saved. Please restart the tool or continue using the menu.',
         backToMenu: 'Back to Menu'
     },
+    colorPreview: {
+        input: 'Enter color (Hex/RGB/HSL):',
+        invalid: 'Invalid color format',
+        preview: 'Preview:',
+        copied: 'Copied to clipboard: {{value}}'
+    },
     url: {
         title: 'URL Encode/Decode',
         encode: 'Encode',
@@ -43,5 +51,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,7 @@ export default {
         features: {
             imgBase64: '图片 <-> Base64',
             imgConvert: '图片格式转换',
+            imgSplit: '图片分割工具',
             dominantColor: '图片主色识别',
             placeholderImg: '占位图生成器',
             qrcode: '二维码生成器',
@@ -21,6 +22,7 @@ export default {
             timeFormat: '时间格式化 / 时间戳',
             timeCalc: '时间计算 (差值/偏移)',
             color: '颜色转换 (Hex <-> RGB)',
+            colorPreview: '颜色预览',
             uuid: '生成 UUID',
             hashing: '哈希计算 (MD5/SHA/SM3)',
             mock: 'Mock 文本生成',
@@ -36,6 +38,12 @@ export default {
         saved: '语言已保存。请继续使用。',
         backToMenu: '返回主菜单'
     },
+    colorPreview: {
+        input: '输入颜色 (Hex/RGB/HSL):',
+        invalid: '颜色格式无效',
+        preview: '预览:',
+        copied: '已复制到剪贴板: {{value}}'
+    },
     url: {
         title: 'URL 编码/解码',
         encode: '编码',
@@ -43,5 +51,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}}'
     }
 };