xw-devtool-cli 1.0.19 → 1.0.21

package/README.md

@@ -1,6 +1,6 @@
 # xw-devtool-cli
 
-**中文** | [English Documentation](https://unpkg.com/xw-devtool-cli@latest/README_EN.md)
+**中文** | [English](#english)
 
 一个基于 Node.js 的开发者命令行工具箱，旨在提供开箱即用的常用开发工具，帮助开发者快速处理日常任务。
 
@@ -10,7 +10,7 @@
 
 - **Base64 工具**：支持字符串与 Base64 互转，支持从剪贴板、文件或手动输入读取。
 - **图片工具**：
-  - **图片格式转换**：支持 PNG、JPG、WebP 格式互转，可调整压缩质量。
+  - **图片格式转换**：支持 PNG、JPG、WebP、ICO 格式互转，可调整压缩质量。生成 ICO 时支持自定义尺寸（逗号分隔），留空则默认生成 `256` 尺寸。输出文件名默认带时间戳，避免覆盖。
   - **图片 ↔ Base64**：支持图片转 Base64 字符串，以及 Base64 还原为图片文件。
   - **占位图生成**：快速生成指定尺寸、颜色、文字的占位图片 (Placeholder Image)。
 - **Mock 数据生成**：
@@ -74,31 +74,31 @@ xw-devtool --en  # 英文启动 (Start in English)
 
 ```text
 =================================
-      xw-devtool-cli Menu
+      xw-devtool-cli 菜单
 =================================
-1. Image <-> Base64
-2. Image Format Convert
-3. Placeholder Image Generator
-4. QR Code Generator
-5. URL Encode/Decode
-6. String Encode/Decode (Base64)
-7. Unicode Encode/Decode
-8. HTML Entity Encode/Decode
-9. Variable Format Converter
-a. JSON Format (Minify/Prettify)
-b. Chinese to Pinyin
-c. Time Format / Timestamp
-d. Time Calculation (Diff/Offset)
-e. Color Converter (Hex <-> RGB)
-f. Get UUID
-g. Hash Calculator (MD5/SHA/SM3)
-h. Mock Text
-i. Special Characters (Symbols)
-j. Emoji Picker
-k. Markdown Snippets
-l. VS Code Snippet Generator
-s. Settings (Language)
-0. Exit
+1. 图片 ↔ Base64
+2. 图片格式转换
+3. 占位图生成
+4. 二维码生成
+5. URL 编解码
+6. 字符串 Base64 转换
+7. Unicode 编解码
+8. HTML 实体 编码/解码
+9. 变量格式转换
+a. JSON 格式 (压缩/美化)
+b. 中文转拼音
+c. 时间格式 / 时间戳
+d. 时间计算 (差值/偏移)
+e. 颜色转换 (Hex ↔ RGB)
+f. 获取 UUID
+g. 哈希计算 (MD5/SHA/SM3)
+h. Mock 文本
+i. 特殊符号大全
+j. Emoji 输入
+k. Markdown 语法工具
+l. VS Code 代码段生成器
+s. 设置 (语言)
+0. 退出
 =================================
 ```
 
@@ -116,9 +116,10 @@ s. Settings (Language)
 ### 2. 图片格式转换
 - 选择 `2` 进入。
 - 选择源图片文件。
-- 选择目标格式 (PNG / JPG / WebP)。
+- 选择目标格式 (PNG / JPG / WebP / ICO)。
 - 设置压缩参数（如 JPG 质量 1-100，PNG 压缩等级 0-9）。
 - 生成的新图片将保存在源文件同级目录。
+- 生成 ICO 时可自定义尺寸，留空默认生成 `256` 尺寸；输出文件名包含时间戳。
 
 ### 3. 占位图生成 (Placeholder Image)
 - 选择 `3` 进入。
@@ -269,6 +270,230 @@ s. Settings (Language)
   - **注意**：为防止长文本刷屏，结果**仅自动复制到剪贴板**，不会在终端打印。
   - **提示**：生成的代码段会自动包含语法速查表 (Syntax Cheatsheet) 作为注释，方便参考。
 
-## 📄 License
+ ## 📄 License
+ 
+ ISC
+
+---
+
+## English
+
+**English** | [中文](#xw-devtool-cli)
+
+A Node.js-based developer command-line toolbox designed to provide out-of-the-box common development tools to help developers handle daily tasks quickly.
+
+Key features include: Base64 encoding/decoding, image format conversion, image <-> Base64, Mock data generation, timestamp/date formatting, time calculation, URL encoding/decoding, UUID generation, Chinese pinyin conversion, color conversion, variable format conversion, hash calculation, QR code generation, special symbols, Markdown snippets, VS Code snippet generation, etc. All results are automatically copied to the clipboard, greatly improving development efficiency.
+
+### ✨ Features
+
+- **Base64 Tools**: Convert strings to/from Base64, supports reading from clipboard, file, or manual input.
+- **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.
+  - **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.
+  - Supports batch generation.
+- **Time Tools**:
+  - **Formatting**: Timestamp/Date string -> `YYYY-MM-DD HH:mm:ss`.
+  - **Timestamp**: Quickly get current millisecond timestamp.
+  - **Calculation**: Calculate date differences or offsets (Add/Subtract).
+- **Dev Tools**:
+  - **URL Encode/Decode**
+  - **Unicode Encode/Decode**: Text <-> Unicode escape sequences (\uXXXX).
+  - **UUID**: Generate UUID v4.
+  - **Pinyin**: Convert Chinese characters to Pinyin (without tone).
+  - **Color Converter**: Hex <-> RGB.
+  - **Variable Format**: CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase.
+  - **Hash Calculator**: MD5, SHA1, SHA256, SHA512, SM3.
+  - **QR Code**: Display QR codes in terminal, save as PNG.
+  - **Special Symbols**: 170+ symbols, arrows, math symbols, etc.
+  - **Emoji Picker**: Browse and copy emojis.
+  - **HTML Entity**: Encode/Decode HTML entities.
+  - **Markdown Snippets**: Common Markdown templates.
+  - **VS Code Snippets**: Generate VS Code snippet JSON from code.
+- **Convenience**:
+  - File selection dialog (Windows).
+  - Auto-copy results to clipboard.
+  - Auto-read from clipboard.
+  - Save large results to file.
+- **Internationalization (i18n)**:
+  - Support **English** and **Chinese**.
+  - Switch via **Settings** in the menu or use CLI flags: `xw-devtool --en` / `xw-devtool --zh`.
+
+### 📦 Installation
+
+#### Global Installation (Recommended)
+```bash
+npm install -g xw-devtool-cli
+```
+After installation, use `xw-devtool` or `xw-dev` command.
+
+#### Run via npx
+```bash
+npx xw-devtool-cli@latest
+```
 
-ISC
+### 🚀 Quick Start
+
+Run in terminal:
+```bash
+xw-devtool
+```
+
+Or specify language directly:
+```bash
+xw-devtool --en  # Start in English
+xw-devtool --zh  # Start in Chinese
+```
+
+The interactive menu will appear:
+
+```text
+=================================
+      xw-devtool-cli Menu
+=================================
+1. Image <-> Base64
+2. Image Format Convert
+3. Placeholder Image Generator
+4. QR Code Generator
+5. URL Encode/Decode
+6. String Encode/Decode (Base64)
+7. Unicode Encode/Decode
+8. HTML Entity Encode/Decode
+9. Variable Format Converter
+a. JSON Format (Minify/Prettify)
+b. Chinese to Pinyin
+c. Time Format / Timestamp
+d. Time Calculation (Diff/Offset)
+e. Color Converter (Hex <-> RGB)
+f. Get UUID
+g. Hash Calculator (MD5/SHA/SM3)
+h. Mock Text
+i. Special Characters (Symbols)
+j. Emoji Picker
+k. Markdown Snippets
+l. VS Code Snippet Generator
+s. Settings (Language)
+0. Exit
+=================================
+```
+
+### 📖 Detailed Usage
+
+#### 1. Image <-> Base64
+- Select `1`.
+- **Image -> Base64**:
+  - Select image file.
+  - Output Base64 string (can save to `.txt`).
+- **Base64 -> Image**:
+  - Input Base64 string (file or clipboard).
+  - Auto-detect format and save as file.
+
+#### 2. Image Format Convert
+- Select `2`.
+- Select source image.
+- Select target format (PNG / JPG / WebP).
+- Set quality/compression.
+- Saved in the same directory.
+
+#### 3. Placeholder Image Generator
+- Select `3`.
+- **Mode 1: Local Image File**
+  - Generate file locally.
+  - Customize: Size, Colors, Text, Format.
+- **Mode 2: Remote Image URL**
+  - Generate URL and copy to clipboard.
+  - Supports: Picsum Photos, DummyImage, Via Placeholder, Placehold.jp, DevTool Tech, FPO Img.
+
+#### 4. QR Code Generator
+- Select `4`.
+- Input text or URL.
+- Preview in terminal.
+- Option to save as PNG.
+
+#### 5. URL Encode/Decode
+- Select `5`.
+- Select `Encode` or `Decode`.
+- Input URL, result auto-copied.
+
+#### 6. String Base64
+- Select `6`.
+- Input sources: Clipboard, File, Manual.
+- Output: Copy, Save to file.
+
+#### 7. Unicode Encode/Decode
+- Select `7`.
+- **Encode**: Text to Unicode escape sequences.
+  - **Non-ASCII Only**: Recommended.
+  - **All Characters**.
+- **Decode**: Unicode to Text.
+
+#### 8. HTML Entity Encode/Decode
+- Select `8`.
+- **Standard**: Special chars only.
+- **Everything**: All chars.
+
+#### 9. Variable Format Converter
+- Select `9`.
+- Input variable name.
+- Shows CamelCase, PascalCase, SnakeCase, KebabCase, ConstantCase.
+- Select one to copy.
+
+#### 10. JSON Format
+- Select `a`.
+- **Minify**: Remove whitespace.
+- **Prettify (2/4 spaces)**.
+- **Note**: Results copied to clipboard only (to avoid flooding terminal).
+
+#### 11. Chinese to Pinyin
+- Select `b`.
+- Input Chinese string.
+- Output Pinyin (no tone).
+
+#### 12. Time Format
+- Select `c`.
+- Timestamp <-> Date String.
+- Enter to get current timestamp.
+
+#### 13. Time Calculation
+- Select `d`.
+- **Diff**: Calculate difference between two dates.
+- **Offset**: Calculate date after add/subtract time units.
+
+#### 14. Color Converter
+- Select `e`.
+- Hex <-> RGB.
+
+#### 15. Get UUID
+- Select `f`.
+- Generate UUID v4.
+
+#### 16. Hash Calculator
+- Select `g`.
+- Input text.
+- Shows MD5, SHA1, SHA256, SHA512, SM3.
+
+#### 17. Mock Data
+- Select `h`.
+- Generate Lorem Ipsum, Names, IDs, Emails, Phones, etc.
+
+#### 18. Special Symbols
+- Select `i`.
+- Grid view of symbols.
+- Select index to copy.
+
+#### 19. Emoji Picker
+- Select `j`.
+- Categorized emojis.
+- Select to copy.
+
+#### 20. Markdown Snippets
+- Select `k`.
+- Templates for Headers, Lists, Tables, Links, etc.
+
+#### 21. VS Code Snippet Generator
+- Select `l`.
+- Convert code to `.code-snippets` JSON body.
+- Auto-escapes quotes/newlines.
+- Copied to clipboard.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -75,6 +75,7 @@
     "qrcode": "^1.5.4",
     "sharp": "^0.33.5",
     "tinycolor2": "^1.6.0",
-    "uuid": "^13.0.0"
+    "uuid": "^13.0.0",
+    "to-ico": "^1.1.5"
   }
 }

package/src/commands/imgConvert.js

@@ -2,6 +2,7 @@ import inquirer from 'inquirer';
 import fs from 'fs';
 import path from 'path';
 import sharp from 'sharp';
+import toIco from 'to-ico';
 import { selectFromMenu } from '../utils/menu.js';
 import { selectFile, saveFile } from '../utils/fileDialog.js';
 import { defaultFileName } from '../utils/output.js';
@@ -15,7 +16,8 @@ function getExt(p) {
 function suggestOutputPath(inputPath, targetExt) {
     const dir = path.dirname(inputPath);
     const base = path.basename(inputPath, path.extname(inputPath));
-    return path.join(dir, `${base}.${targetExt}`);
+    const ts = Date.now();
+    return path.join(dir, `${base}-${ts}.${targetExt}`);
 }
 
 async function pickInputFile() {
@@ -48,7 +50,8 @@ async function pickTargetFormat(currentExt) {
     const options = [
         { name: 'png', value: 'png' },
         { name: 'jpg', value: 'jpg' },
-        { name: 'webp', value: 'webp' }
+        { name: 'webp', value: 'webp' },
+        { name: 'ico', value: 'ico' }
     ].filter(o => o.value !== currentExt);
     return await selectFromMenu('Target format', options);
 }
@@ -69,6 +72,18 @@ async function pickQuality(targetExt) {
             { type: 'number', name: 'quality', message: 'WebP quality (1-100):', default: 80, validate: n => (n >= 1 && n <= 100) ? true : '1-100' }
         ]);
         return { webpQuality: quality };
+    } else if (targetExt === 'ico') {
+        const { sizesStr } = await inquirer.prompt([
+            { type: 'input', name: 'sizesStr', message: 'Enter ICO sizes (comma-separated). Leave empty for default 256:', default: '' }
+        ]);
+        const defaultSizes = [256];
+        const allowed = new Set([16, 24, 32, 48, 64, 128, 256]);
+        const parsed = (sizesStr || '')
+            .split(',')
+            .map(s => parseInt(s.trim()))
+            .filter(n => Number.isFinite(n) && allowed.has(n));
+        const uniq = Array.from(new Set(parsed));
+        return { icoSizes: uniq.length ? uniq : defaultSizes };
     }
     return {};
 }
@@ -82,7 +97,7 @@ export async function imgConvertHandler() {
     console.log(`Target format: ${targetExt}`);
     const opts = await pickQuality(targetExt);
 
-    let outPath = saveFile(suggestOutputPath(inputPath, targetExt), 'Image Files|*.png;*.jpg;*.jpeg;*.webp|All Files|*.*');
+    let outPath = saveFile(suggestOutputPath(inputPath, targetExt), 'Image Files|*.png;*.jpg;*.jpeg;*.webp;*.ico|All Files|*.*');
     if (!outPath) {
         const def = suggestOutputPath(inputPath, targetExt);
         const ans = await inquirer.prompt([
@@ -93,19 +108,27 @@ export async function imgConvertHandler() {
 
     try {
         fs.mkdirSync(path.dirname(outPath), { recursive: true });
-        let pipeline = sharp(inputPath);
-        if (targetExt === 'png') {
-            pipeline = pipeline.png({ compressionLevel: opts.pngCompressionLevel ?? 6 });
-        } else if (targetExt === 'jpg') {
-            pipeline = pipeline.jpeg({ quality: opts.jpegQuality ?? 80 });
-            if (inputExt !== 'jpg') {
-                pipeline = pipeline.flatten({ background: { r: 255, g: 255, b: 255 } });
+        if (targetExt === 'ico') {
+            const basePng = await sharp(inputPath).ensureAlpha().png().toBuffer();
+            const sizes = opts.icoSizes ?? [16, 24, 32, 48, 64, 128, 256];
+            const icoBuffer = await toIco([basePng], { resize: true, sizes });
+            fs.writeFileSync(outPath, icoBuffer);
+            console.log(`Converted to ICO: ${inputPath} -> ${outPath}`);
+        } else {
+            let pipeline = sharp(inputPath);
+            if (targetExt === 'png') {
+                pipeline = pipeline.png({ compressionLevel: opts.pngCompressionLevel ?? 6 });
+            } else if (targetExt === 'jpg') {
+                pipeline = pipeline.jpeg({ quality: opts.jpegQuality ?? 80 });
+                if (inputExt !== 'jpg') {
+                    pipeline = pipeline.flatten({ background: { r: 255, g: 255, b: 255 } });
+                }
+            } else if (targetExt === 'webp') {
+                pipeline = pipeline.webp({ quality: opts.webpQuality ?? 80 });
             }
-        } else if (targetExt === 'webp') {
-            pipeline = pipeline.webp({ quality: opts.webpQuality ?? 80 });
+            await pipeline.toFile(outPath);
+            console.log(`Converted: ${inputPath} -> ${outPath}`);
         }
-        await pipeline.toFile(outPath);
-        console.log(`Converted: ${inputPath} -> ${outPath}`);
     } catch (e) {
         console.error('Conversion error:', e.message);
     }