xw-devtool-cli 1.0.7 → 1.0.9

package/README.md

@@ -10,6 +10,7 @@
 - **图片工具**：
   - **图片格式转换**：支持 PNG、JPG、WebP 格式互转，可调整压缩质量。
   - **图片 ↔ Base64**：支持图片转 Base64 字符串，以及 Base64 还原为图片文件。
+  - **占位图生成**：快速生成指定尺寸、颜色、文字的占位图片 (Placeholder Image)。
 - **Mock 数据生成**：
   - 支持生成：英文段落 (Lorem Ipsum)、中文字符、中国居民身份证号、电子邮箱、URL、订单号、手机号、座机号。
   - 支持批量生成。
@@ -26,6 +27,8 @@
   - **二维码生成**：终端直接显示二维码，支持保存为 PNG 图片（带时间戳文件名）。
   - **特殊符号大全**：包含常用符号、箭头、数学符号、货币、希腊字母等 170+ 个符号，支持一键复制。
   - **Emoji 输入**：支持分类查看和选择常用 Emoji，一键复制到剪贴板。
+  - **HTML 实体工具**：支持 HTML 实体编码与解码 (如 `&` <-> `&amp;`)。
+  - **占位图生成**：自定义尺寸、背景色、文字颜色和格式生成占位图。
 - **便捷操作**：
   - 支持文件选择对话框 (Windows)。
   - 结果自动复制到剪贴板。
@@ -72,6 +75,8 @@ b. Hash Calculator (MD5/SHA/SM3)
 c. QR Code Generator
 d. Special Characters (Symbols)
 e. Emoji Picker
+f. HTML Entity Encode/Decode
+g. Placeholder Image Generator
 0. Exit
 =================================
 ```
@@ -158,6 +163,23 @@ e. Emoji Picker
 - 分类展示常用 Emoji (表情、手势、动物、食物等)。
 - 输入编号选择并复制 Emoji 到剪贴板。
 
+### 15. HTML 实体编码/解码
+- 选择 `f` 进入。
+- 支持两种编码模式：
+  - **Standard**: 仅编码特殊字符（如 `<` `>` `&` 及非 ASCII 字符）。
+  - **Everything**: 编码所有字符（包括 ASCII 字母数字）。
+- 支持直接回车读取剪贴板内容。
+- 结果自动复制到剪贴板。
+
+### 16. 占位图生成 (Placeholder Image)
+- 选择 `g` 进入。
+- 支持自定义：
+  - **尺寸**: 宽度和高度 (px)。
+  - **颜色**: 背景色和文字颜色（支持 Hex 或颜色名）。
+  - **内容**: 自定义图片中间的文字（默认显示尺寸）。
+  - **格式**: 输出 PNG, JPG, WebP, GIF。
+- 文件名默认包含时间戳，避免覆盖。
+
 ## 📄 License
 
 ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xw-devtool-cli",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "type": "module",
   "description": "基于node的开发者助手cli",
   "main": "index.js",
@@ -48,6 +48,7 @@
     "clipboardy": "^5.0.2",
     "commander": "^14.0.2",
     "dayjs": "^1.11.19",
+    "he": "^1.2.0",
     "inquirer": "^13.1.0",
     "lorem-ipsum": "^2.0.8",
     "pinyin": "^4.0.0",

package/src/commands/htmlEntities.js

@@ -0,0 +1,57 @@
+import inquirer from 'inquirer';
+import he from 'he';
+import { copy, read } from '../utils/clipboard.js';
+import { selectFromMenu } from '../utils/menu.js';
+
+export async function htmlEntitiesHandler() {
+    const mode = await selectFromMenu('HTML Entity Encode/Decode', [
+        { name: 'Encode (Standard - Special chars only)', value: 'encode' },
+        { name: 'Encode (Everything - All chars)', value: 'encodeAll' },
+        { name: 'Decode (HTML Entities -> Text)', value: 'decode' }
+    ]);
+
+    const actionName = mode.startsWith('encode') ? 'encode' : 'decode';
+
+    const { input } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'input',
+            message: `Enter text to ${actionName} (Press Enter to paste from clipboard):`
+        }
+    ]);
+
+    let textToProcess = input;
+
+    if (!textToProcess || textToProcess.trim().length === 0) {
+        textToProcess = await read();
+        if (!textToProcess || textToProcess.trim().length === 0) {
+            console.log('Clipboard is empty or could not be read.');
+            return;
+        }
+        console.log(`\nUsing clipboard content: "${textToProcess.length > 50 ? textToProcess.substring(0, 47) + '...' : textToProcess}"`);
+    }
+
+    let result;
+    try {
+        if (mode === 'encode') {
+            // Standard encode: only special chars like < > & " ' and non-ASCII
+            result = he.encode(textToProcess, { encodeEverything: false });
+        } else if (mode === 'encodeAll') {
+            // Encode everything: includes ASCII alphanumeric
+            result = he.encode(textToProcess, { encodeEverything: true });
+        } else {
+            result = he.decode(textToProcess);
+        }
+        
+        console.log(`\nResult:\n${result}\n`);
+        
+        if (mode === 'encode' && result === textToProcess) {
+             console.log('(Note: No special characters were found to encode. Use "Encode (Everything)" if you want to encode standard letters.)\n');
+        }
+
+        await copy(result);
+        console.log('Result copied to clipboard!');
+    } catch (e) {
+        console.error(`Error processing HTML entities (${mode}):`, e.message);
+    }
+}

package/src/commands/placeholderImg.js

@@ -0,0 +1,88 @@
+import inquirer from 'inquirer';
+import sharp from 'sharp';
+import path from 'path';
+
+export async function placeholderImgHandler() {
+    console.log('\n--- Generate Placeholder Image ---\n');
+
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'width',
+            message: 'Width (px):',
+            default: '300',
+            validate: (input) => {
+                const val = parseInt(input);
+                return !isNaN(val) && val > 0 ? true : 'Please enter a valid positive number';
+            }
+        },
+        {
+            type: 'input',
+            name: 'height',
+            message: 'Height (px):',
+            default: '200',
+            validate: (input) => {
+                const val = parseInt(input);
+                return !isNaN(val) && val > 0 ? true : 'Please enter a valid positive number';
+            }
+        },
+        {
+            type: 'input',
+            name: 'bgColor',
+            message: 'Background Color (Hex/Name):',
+            default: '#cccccc'
+        },
+        {
+            type: 'input',
+            name: 'textColor',
+            message: 'Text Color (Hex/Name):',
+            default: '#333333'
+        },
+        {
+            type: 'input',
+            name: 'text',
+            message: 'Text (leave empty for size):',
+        },
+        {
+            type: 'list',
+            name: 'format',
+            message: 'Output Format:',
+            choices: ['png', 'jpg', 'webp', 'gif'],
+            default: 'png'
+        },
+        {
+            type: 'input',
+            name: 'filename',
+            message: 'Filename (without extension):',
+            default: () => `placeholder-${Date.now()}`
+        }
+    ]);
+
+    const width = parseInt(answers.width);
+    const height = parseInt(answers.height);
+    const text = answers.text || `${width}x${height}`;
+    const fontSize = Math.floor(Math.min(width, height) / 5); // Heuristic for font size
+    
+    // Create SVG buffer
+    const svgImage = `
+    <svg width="${width}" height="${height}" version="1.1" xmlns="http://www.w3.org/2000/svg">
+      <rect width="100%" height="100%" fill="${answers.bgColor}" />
+      <text x="50%" y="50%" font-size="${fontSize}" fill="${answers.textColor}" text-anchor="middle" dy=".3em" font-family="Arial, sans-serif">${text}</text>
+    </svg>
+    `;
+
+    const buffer = Buffer.from(svgImage);
+
+    const outputFilename = `${answers.filename}.${answers.format}`;
+    const outputPath = path.resolve(process.cwd(), outputFilename);
+
+    try {
+        await sharp(buffer)
+            .toFormat(answers.format)
+            .toFile(outputPath);
+        
+        console.log(`\nImage generated successfully: ${outputPath}`);
+    } catch (error) {
+        console.error(`\nFailed to generate image: ${error.message}`);
+    }
+}

package/src/index.js

@@ -14,6 +14,8 @@ import { hashingHandler } from './commands/hashing.js';
 import { qrcodeHandler } from './commands/qrcode.js';
 import { specialCharsHandler } from './commands/specialChars.js';
 import { emojiHandler } from './commands/emoji.js';
+import { htmlEntitiesHandler } from './commands/htmlEntities.js';
+import { placeholderImgHandler } from './commands/placeholderImg.js';
 
 process.on('SIGINT', () => {
     console.log('\nBye!');
@@ -44,7 +46,9 @@ const features = [
     { name: 'Hash Calculator (MD5/SHA/SM3)', value: 'hashing' },
     { name: 'QR Code Generator', value: 'qrcode' },
     { name: 'Special Characters (Symbols)', value: 'specialChars' },
-    { name: 'Emoji Picker', value: 'emoji' }
+    { name: 'Emoji Picker', value: 'emoji' },
+    { name: 'HTML Entity Encode/Decode', value: 'htmlEntities' },
+    { name: 'Placeholder Image Generator', value: 'placeholderImg' }
 ];
 
 async function main() {
@@ -165,6 +169,12 @@ async function handleAction(action) {
         case 'emoji':
             await emojiHandler();
             break;
+        case 'htmlEntities':
+            await htmlEntitiesHandler();
+            break;
+        case 'placeholderImg':
+            await placeholderImgHandler();
+            break;
         default:
             console.log('Feature not implemented yet.');
     }